Loggly offers seamless integration with Atlassian’s JIRA Software. JIRA integration encourages collaboration between product and operations team members. If you identify a problem and want to track it in JIRA, you can now create and update a JIRA issue directly from Loggly with the required event information. You could also add comments directly from the Loggly UI if you have this integration enabled.
Note: This integration is only available to customers in the Enterprise tier and limited to JIRA Software Cloud.
Only account owners and account administrators can set up JIRA integration within Loggly. If that’s not you, contact your Loggly admin. Once the integration setup is successfully completed, any user in your account with access to Loggly can create an issue in JIRA from Loggly itself.
Note: Loggly needs to access JIRA on behalf of your users. We recommend creating a specific user in JIRA for this purpose. Linking it to someone specific in your account would tie up the integration to that person’s account which is not optimal.
Step 1. If you are the account owner or admin, go to the Source Setup page in Loggly and click on JIRA Integration.
Step 2. Complete the above form using settings for your JIRA implementation.
- JIRA URL: Enter the complete JIRA account URL with HTTPS.
- Email: Enter the JIRA account email for the account that Loggly will use to log into the system.
- API Token: Create an API Token for the account that Loggly will use to log into the system and enter it here.
Then, click on "Connect to JIRA". You will see a "Connection established successfully" message if the credentials are valid. You can now create an issue from the Loggly Search page from any event.
Step 3. Create Template for JIRA Issues (optional).
After you have successfully established the connection, you have the option to create one or more templates which will be used to pre-populate the issue fields at the time of creating an issue. This will speed up the process of creating issues.
Saving a template will pre-populate your JIRA issue fields when you create a new issue. We support multiple templates. You can specify a default template if you have created many templates. If only one template is created, then that is the default and Loggly will use it to pre-populate the form to create an issue.
Please note: Since each JIRA deployment is unique to each customer, the fields displayed on the form will be different.
- All mandatory fields for each project are marked with an asterisk.
- You can reset all the fields to start over.
- Loggly will use the default template to pre-populate the issue fields at the time of creating an issue from a log event.
Below is a sample template created by selecting the appropriate project and selecting appropriate options.
So, create as many templates as you need and make sure to click Save.
Step 1. Go to the Search page and hover and click on the icon located on the far right side of the event of interest, as shown below, to reveal the option available. Select Create issue.
Step 2. A new issue creation popup opens with JIRA’s system fields and project specific mandatory fields.
If a default template is available, the fields are pre-populated. Make any required adjustments on the form and then click Create Issue. A new issue is created and you will get a confirmation message as shown below with the JIRA ticket number.
Step 1. Click on the icon located on the far right side of the event of interest and select Add to issue.
Step 2. In the drop down window, you could start typing in the text box to narrow down the search and then select the JIRA issue to which you want to add this event information.
By default, the event details and permalink will be included in the description field of the JIRA issue as shown in the image above. You could change this behavior by unselecting the checkboxes.
Click on the Link button when you are done. This will update the selected JIRA ticket automatically.
Add a comment to an existing issue
Step 1. Click on the icon located on the far right side of the event of interest and select Add comment.
Step 2. Select the existing JIRA ticket to which you want to add comments. Add your comments in the text box and then click Add. The selected JIRA ticket will be updated automatically with your comments, the event details and permalink as per your selection.
When the APM Integrated Experience is enabled, Loggly shares a common navigation and enhanced feature set with the other integrated experiences' products. How you navigate Loggly and access its features may vary from these instructions. For more information, go to the APM Integrated Experience documentation.