Grafana Datasource that connects to JIRA and analyses data to produce team management metrics such as velocity and cycle time

• Create a .env file like the .env-example file but with your JIRA credentials (the password is the key you generate from your atlassian account, not your actual password)
• If using VS Code, run a debug session using the "Launch via npm" configuration
• From the command link run it with npm using npm start

Many of the queries the service supports have required and optional parameters supplied using custom JSON input data such as in the image below.

The configuration options for each metric are specified here.

Example: {"toStatus": "Deployed", "projectKey": "ENG", "teamId": 9, "addBugsDefault": false}

Example: {"toStatus": "Deployed", "projectKey": "ENG", "addBugsDefault": true, "bugDefaultSize": 2}

Example: {"toStatus": "Deployed", "fromStatus": "Prioritised", "projectKey": "ENG"}

Example: {"toStatus": "Deployed", "fromStatus": "Prioritised", "projectKey": "ENG"}

Example: {"versionIds": [10173, 10166]}

Example:

{
  "releaseId": 10173, 
  "toStatus": "Business Acceptance",
  "projectKey": "ENG",
  "vSource": "Explicit",
  "vBounds": {
    "max": 60,
    "cur": 40,
    "min": 30
  },
  "releaseDate": "2020/02/28",
  "addBugsDefault": true,
  "bugDefaultSize": 2
}

Make sure the Simple JSON plugin is installed on your grafana instance:

sudo grafana-cli plugins install simpod-json-datasource

Set up the datasource:

1. Add new datasource in the Grafana UI
2. Name: JSON
3. URL: http://localhost:3030
4. Everything else turned off

Set up the dashboard:

1. Go to manage dashboards on the Grafana UI
2. Click "Upload JSON"
3. Navigate to the json file in the grafana sub-directory of this project on your lcoal machine and import it

To run this as a service on a raspberry pi:

1. sudo cp jira-metrics.service /etc/systemd/system/
2. sudo chmod u+rwx /etc/systemd/system/jira-metrics.service
3. sudo systemctl enable jira-metrics

To control the service manually:

Start: sudo systemctl start jira-metrics Stop: sudo systemctl stop jira-metrics

To see the output log:

cat /var/log/syslog