Documentation forLoggly

Integration with JIRA

Navigation Notice: When the APM Integrated Experience is enabled, Loggly shares a common navigation and enhanced feature set with other integrated experience products. How you navigate Loggly and access its features may vary from these instructions.

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 create and update a JIRA issue directly from Loggly with the required event information. You can also add comments directly from the Loggly UI if you have this integration enabled.

This integration is only available to customers in the Enterprise tier and limited to JIRA Software Cloud.

Configuring JIRA Integration

Only Loggly account owners and account administrators can set up JIRA integration within Loggly. If you are not an account owner or account administrator, contact your Loggly admin. After integration setup is successfully completed, any user in your account with access to Loggly can create an issue in JIRA from Loggly.

Loggly needs to access JIRA on behalf of your users. Solarwinds recommends creating a new specific user in JIRA for this purpose. Linking to an existing user's account is not recommended. The existing user's account would be tied up by the JIRA integration.
  1. If you are the account owner or admin, In Loggly go to the Source Setup page and click on JIRA Integration.

  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 in the API Token field.

    Click Connect to JIRA. If the credentials are valid you see a message stating Connection established successfully. You can then create an issue from the Loggly Search page for any event.

  3. (Optional) Create Template for JIRA Issues.

    After you have successfully established the connection, you have the option to create one or more templates that can be used to pre-populate the issue fields at the time the issue is created. Pre-populating through the use of templates speeds up the process of creating issues.

    Saving a template pre-populates your JIRA issue fields when you create a new issue. Loggly supports multiple templates. You can specify a default template if you have created multiple templates. If only one template is created, then it is the default and Loggly uses it to pre-populate the form when creating an issue.

    screen-shot-2016-09-11-at-10-38-03-am

    Because 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 uses the default template to pre-populate the issue fields at the time an issue is created from a log event.

    Below is a sample template created by selecting the appropriate project and options.
    After creating a template, click Save. Create as many templates as needed.

    screen-shot-2016-09-11-at-10-45-14-am

Creating a New Issue

  1. On the Search page, hover and click the action icon (three vertical dots) located on the far right of the event of interest, as shown below, to reveal the option available. Select Create issue.

    create issue

    A new issue creation dialog opens with JIRA’s system fields and project specific mandatory fields.

    Create Issue Field

  2. 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 a confirmation message displays. The confirmation message contains the JIRA ticket number.

    JIRA Ticket Number

Add Event Details to an Existing Issue

  1. Click the action icon (three vertical dots) located to the far right of the event of interest, and then select Add to issue.

    add issue

  2. In the drop-down window, narrow the search by typing into the text box, and then select the JIRA issue you want to add to the event information.

    add to issue

  3. By default, the event details and permalink are included in the description field of the JIRA issue as shown in the image above. You can change this behavior by clearing the check boxes.

  4. When finished, click the Link button. The selected JIRA ticket will update automatically.

Add a Comment to an Existing Issue

  1. Click the action icon (three vertical dots) located to the far right of the event of interest, and the select Add comment.

    add comment

  2. Select the existing JIRA ticket to which you want to add comments. Add comments in the text box, and then click Add. Based on your selections here, the selected JIRA ticket updates automatically with your comments, the event details, and the permalink .

    add comment