JIRA plugin

This plugin collects ticket data from your JIRA core, software and service desk instances.Get data for ongoing and historical JIRA tickets into TrueSight Intelligence as events. Use the historical data for retrospective analysis and understand key trends and patterns in your JIRA tickets. Use event clustering to perform advanced analytics. Configure multiple instances to collect data from multiple JIRA instances with independent polling intervals.

This topic describes the procedure to get JIRA data into TrueSight Intelligence. Some of the salient features are:

  • JIRA tickets are available in the form of events in TrueSight Intelligence.
  • A TrueSight Intelligence App is created using the app_id specified as part of the properties in the eventDefinition section of the json template.
  • Use the Events feature to filter and view tickets for a specific time period. For more information, see Viewing abnormality and MVGD events.
  • Use the event clustering feature to cluster the tickets based on predefined parameters. For more information, see Clustering event data for advanced analysis.

Prerequisites

Meter 4.7.0-852 or later must be installed.

Java 1.8 must be installed

The JIRA plugin supports the following Operating Systems.

Linux(tick)
Windows(tick)
OS X(tick)

Before you begin

Make sure that the field names do not contain any special characters (only _ is allowed). A system validation will prevent ingestion from progressing if the field names contain special characters.

To ingest historical JIRA data

If you want to ingest historical JIRA data into TrueSight Intelligence, it is recommended that you ingest the historical data before configuring this plugin for data collection.

Use the JIRA bulk ingestion script to get historical JIRA tickets. Based on the configuration details provided in the template, this script reads the tickets, converts them into TrueSight Intelligence events, and ingests these events into TrueSight Intelligence.


To install the plugin

  1. From the top right of the screen, perform one of the following actions:
    • Click Settings > Data Collection, select the TrueSight meter, and select the Sources tab.

    • Click Settings > Configure Sources.
  2. Use the search box or scroll through the page to find the source system which has the TrueSight meter on which you want to install the plugin.
  3. Click the name of the source to view source details.
  4. Select the Plugins tab.
  5. Use the search box or scroll through the page to find the plugin you want to install.
  6. Click + Install to start the installation.

    Refer to the following sections for the configuration details required to collect data and view the list of plugin metrics.

Configuration details

FieldDescription
App ID

The App ID using which the events will be tagged. If the App does not exist, a new App is created.

SourceThe source name that will be used by all tickets that are available as events. For instance, an indicator for the JIRA instance to which you are connecting.
Host NameThe host name of the JIRA server
PortThe port used by the JIRA server
UsernameThe username used to access the JIRA server
PasswordThe password used to access the JIRA server
Protocol TypeThe protocol used to access the JIRA server. HTTP and HTTPS are supported.
Field Mapping

The fields for which the information will be collected. Use the filter code block to specify the JIRA fields and values that you want to send to TrueSight Intelligence.

For example, "status": ["Open"] and "priority": ["Important"] will only get Open JIRA tickets with the priority set to Important.

For more information, see the Template section.

Poll IntervalFrequency (in minutes) used to poll for collecting the tickets

Template

By default, the out-of-the-box "filter" configuration will only get JIRA tickets with status set to Closed, Open, and Resolved. Change the default filter for the status and set filter for other fields as required.

For example, if you want to get Closed and Resolved tickets for a project named TrueSight Intelligence, use the following:

"filter": {
     "status": ["Closed","Resolved"],

     "project": ["TrueSight Intelligence”]

           }

jiraDefaultTemplate.json

Advanced configuration

To customize this plugin, see JIRA plugin on GitHub.

Plugin metrics

This plugin does not collect metric data. JIRA tickets are made available as TrueSight Intelligence events.

Was this page helpful? Yes No Submitting... Thank you

Comments