Atlassian Insight & Jira Service Management

All runZero editions integrate with Jira Service Management via an import in Atlassian Insight. runZero asset data is then imported into the CMDB.

Follow these steps to perform a basic import.

Step 1: Export runZero asset data

You can export data using the Export button from the runZero inventory or the Export API.

The following are sample commands for the export API that include common export fields but omit the tags field. You must 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 does not accept any attribute longer than 255 characters and will produce errors if you are trying to import a file that contains longer fields. If you are seeing such errors, you may need to either trim or omit the fields.

Step 2: Import data into Atlassian Insight

You must use Jira Service Management Premium or Enterprise and have Atlassian Insight installed for the following steps to work.

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

  2. Name the object schema. In our example, we’re calling it Assets.

  3. Click on … 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, depending on your previous export and click Next.

  2. Enter the name for your 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 have previously exported form 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. You will see a new entry with your configured import on the page. Click the settings cog and select Execute Import.

Jira Service Management - Execute import

  1. Click Import.

Jira Service Management - Confirm importing

  1. Your import was successful. Close the window.

Jira Service Management - Finished process in action

If you are seeing the following error, one of your fields is longer than 255 characters. Manually trim the field to 255 characters or delete the field to successfully import your assets.

Jira Service Management - Import error

Step 3: View your imported assets

  1. In Jira Service Management, click on the Insights.
  2. Click on your object schema.
  3. Click on assets to view details.

Jira Service Management - Imported assets

Updated
Previous: Outbound integrations Next: Panther