Atlassian Insight & Jira Service Management

View as Markdown

This page covers the asset-enrichment integration that imports runZero asset data into Jira Service Management’s CMDB. To push runZero issues to Jira as tickets and sync changes back, use the Jira integration instead.

All runZero editions integrate with Jira Service Management through an import in Atlassian Insight, which loads runZero asset data into the CMDB.

Step 1: Export runZero asset data

Export data with the Export button in the runZero inventory, or with the Export API.

These sample Export API commands include the common export fields and omit the tags field. Replace the token ETxxx... with your account’s export token from the Inventory export API page.

For a CSV export, use this command (one line):

curl -o "assets.csv" -H "Authorization: Bearer ETxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 
  "https://console.runzero.com:443/api/v1.0/export/org/assets.csv"

For a JSON export, use this command (one line):

curl -o "assets.json" -H "Authorization: Bearer ETxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 
  "https://console.runzero.com:443/api/v1.0/export/org/assets.csv"
Atlassian Insight rejects any attribute longer than 255 characters and reports errors when an imported file contains longer fields. If you see those errors, you may need to trim or omit the fields.

Step 2: Import data into Atlassian Insight

These steps need Jira Service Management Premium or Enterprise with Atlassian Insight installed.

  1. In Jira Service Management, go to the Insight menu and click the + sign to create an object schema.

  2. Name the object schema. This example calls it Assets.

  3. Click … next to the object schema and choose Configuration.

  4. Go to the Import tab.

  5. Click Create Configuration.

Jira Service Management - Create import configuration

  1. Choose CSV or JSON to match your export, and click Next.

  2. Enter a name for the import.

  3. In the Concatenator field, enter \s.

Jira Service Management - Create import configuration 2

  1. Scroll down and click Next.

  2. Choose the file you exported from runZero.

Jira Service Management - Create import configuration 2

  1. Click Save Import Configuration.

  2. Click Create predefined Insight structure and wait for the task to finish.

  3. Click Create predefined configuration and wait for the task to finish.

Jira Service Management - Create import configuration 3

  1. Close the window. The page now lists your configured import. Click the settings cog and select Execute Import.

Jira Service Management - Execute import

  1. Click Import.

Jira Service Management - Confirm importing

  1. When the import finishes successfully, close the window.

Jira Service Management - Finished process in action

If you see the following error, one of your fields is longer than 255 characters. Trim the field to 255 characters or delete it so the import can succeed.

Jira Service Management - Import error

Step 3: View your imported assets

  1. In Jira Service Management, click Insights.
  2. Click your object schema.
  3. Click an asset to view its details.

Jira Service Management - Imported assets

Updated