Tags – auto SW builds quality status

‘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 that 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 that 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 webhooks, use webhooks to inform coralogix when a 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 a title (for example: “Coralogix builds”)

b) Add URL:  https://webapi.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 an identical name to correspond with your logs application name. – must

e) Subsystem – your desired system name – please use an identical name to correspond with your logs subsystem name, you can add more than 1 subsystem name separated by a 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: https://webapi.coralogix.com/api/v1/tfsonline?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 an identical name to correspond with your logs application name. – must

c) Subsystem – your desired system name – please use an identical name to correspond with your logs subsystem name. you can add more than 1 subsystem name separated by a comma. 

10) Click finish 

3. Integrate Coralogix GitLab:

1) Log in to GitLab using your Credentials.

2) Go to your project page.

3) Go to Settings -> Integrations

4)Add url: https://webapi.coralogix.com/api/v1/gitlab?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 an identical name to correspond with your logs application name. – must

c) Subsystem – your desired system name – please use an identical name to correspond with your logs subsystem name. you can add more than 1 subsystem name separated by a 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: https://webapi.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 comma 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, the current date-time will be applied.

1.  when applying spaces in the URL use: %20 instead.

2. Ampersand is an escape character, make sure you put a ‘\’ 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 (GET):

curl --insecure https://webapi.coralogix.com/api/v1/addTag?key=11111111-1111-1111-1111-111111111111\&application=Application_Name\&subsystem=Subsystem1,Subsystem2,Subsystem3\&name=MyFirstTag\&timestamp=2020-06-23:09:00:00\&iconUrl=your_icon_url

Example (POST):

curl -X POST --insecure https://webapi.coralogix.com/api/v1/addTagPost?key=11111111-1111-1111-1111-111111111111\&application=Application_Name\&subsystem=Subsystem1,Subsystem2,Subsystem3\&name=MyFirstTag\&timestamp=2020-06-23:09:00:00\&iconUrl=your_icon_url