'Tags' is the best way for you to understand your version status at a glance, integrate with your deployment pipeline and get your latest builds status. Whether it’s new exceptions, higher error ratios, or new broken flows - we got you covered
Tags can be anything, they can be received automatically from your pipelines or inserted manually, they can be a new version, a new big customer, or an attribution point to that day when your dev team had sangria at lunch.
Simply go to "Tags" on your top menu, integrate into your pipeline or manually add an event tag, and get a full status in the context of your event.
1) High-level status: Number of Flow Anomalies, Alerts, and the general percentage of high severity logs since the tag time and in comparison to the corresponding time of the day before the tag.
2) Suspected errors: errors which arrived more than their normal ratio (as learned by Coralogix) since the tag.
3) Top errors: Top errors since the tag (maximum appearances).
4) Newly introduced logs: logs which appeared on your system for the first time after the tag/build.
5) Custom widgets: pre-defined Coralogix visualizations based on your own version quality criteria. Learn more about widgets here.
Integrate with your deployment pipelines:
1) Bitbucket
2) TFS
3) GitLab
4) Heroku Pipelines
5) Add version tag using cURL
1. Integrate Coralogix with BitBucket:
Coralogix supports integration with bitbucket web hooks, use web hooks to inform coralogix when new build is issued.
1) Login to bit bucket using your user credentials.
2) Go to your overview page and then go to settings.
3) In settings go to webhooks.
4) Add new webhook.
a) Add title (for example: “Coralogix builds”
b) Add URL: api.coralogix.com/api/v1/bitbucket?key=ADD_YOUR_PRIVATE_KEY&application=YOUR_APPLICATION_NAME&subsystem=YOUR_SUBSYSTEM_NAME&name=YOUR_TAG_NAME
c) Key - use your private key. - must
d) Application - your desired application name - please use identical name to correspond with your logs application name. - must
e) Subsystem - your desired system name - please use identical name to correspond with your logs subsystem name, you can add more than 1 subsystem name separated by comma.
5) Select trigger
Select build status updated:
6) Click save.
2. Integrate Coralogix TFS:
1) Sign in to TFS using your user credentials.
2) Select your team project.
3) Click settings.
4) Go to Service hooks.
5) Click add new service hooks.
6) Select “Web Hooks"
7) Select “Build Completed” as the trigger.
8) Select Build Status “Succeeded” and click Next.
a) You may choose any filter as you desire.
9) Add URL: api.coralogix.com/api/v1/bitbucket?key=ADD_YOUR_PRIVATE_KEY&application=YOUR_APPLICATION_NAME&subsystem=YOUR_SUBSYSTEM_NAME&name=YOUR_TAG_NAME
a) Key - use your private key. - must
b) Application - your desired application name - please use identical name to correspond with your logs application name. - must
c) Subsystem - your desired system name - please use identical name to correspond with your logs subsystem name. you can add more than 1 subsystem name separated by comma.
10) Click finish
3. Integrate Coralogix GitLab:
1) Login to GitLab using your Credentials:.
2) Go to your project page.
3) Go to Settings -> Integrations
4)Add URL: api.coralogix.com/api/v1/bitbucket?key=ADD_YOUR_PRIVATE_KEY&application=YOUR_APPLICATION_NAME&subsystem=YOUR_SUBSYSTEM_NAME&name=YOUR_TAG_NAME
a) Key - use your private key. - must
b) Application - your desired application name - please use identical name to correspond with your logs application name. - must
c) Subsystem - your desired system name - please use identical name to correspond with your logs subsystem name. you can add more than 1 subsystem name separated by comma.
5) Select PipeLine events.
6) Click Save.
4. Integrate Coralogix Heroku Pipelines:
Simply provision the Coralogix add-on and in case you use Heroku pipelines, Coralogix will integrate into it automatically and you will start seeing your Heroku builds on the Coralogix log timelines and in the Tags display.
5. Add version tag using cURL
You can add version tags per Application and Subsystem using cURL:
URL : api.coralogix.com/api/v1/addTag
key: Your company private key.
Application: your application name.
Subsystem: your subsystem names. You can input more than one subsystem name, use coma delimiter ‘,’ between subsystems names.
Name: your version tag name.
Timestamp: tag timestamp, use this format: YYYY-MM-DD:HH:mm:ss.
if a timestamp is not supplied, current date time will be applied.
1. when applying spaces in the URL use: %20 instead.
2. Ampersand is an escape character make sure to write ‘\’ before.
example: \&application=MyApp
3. Use your own tag picture (optional): Use a URL (URL encoded) to a valid image file that you have uploaded to a public repository (png, jpeg, SVG). Max size 50KB.
Example:
curl --insecure URL: api.coralogix.com/api/v1/addTag?key=11111111-1111-1111-1111-111111111111\&application=Application_Name\&subsystem=Subsystem1,Subsystem2,Subsystem3\&name=MyFirstTag\×tamp=2017-08-08:09:00:00\&iconUrl=your_icon_url