Rely.io
  • 📌What is Rely.io?
  • 💡How Rely.io works
  • 📑Getting Started Guide
    • Create an account for your organization
    • Add your first plugin
    • Import services into the Service Catalog
    • Make the Software Catalog your own
    • What's Next?
  • 🌈Basic Concepts
    • Entities
    • Blueprints
    • Property Data Types
    • Catalogs
    • Data Model
    • Plugins
    • User Blueprints vs Plugin Blueprints
    • Actions and Automations
      • Automation Rules
      • Self-Service Actions
    • Home Pages
    • Scorecards
  • 📚Guides & Tutorials
    • Enhancing Deployment Visibility through Gitlab Pipelines and Rely's API
  • 🖥️Software Catalog
    • Overview and Use Cases
    • Usage Guide
      • Creating a new Entity
      • Updating an Entity
      • Tracking Entity Changes
      • Customizing an Entity's Page
      • Customizing a Catalog
      • Creating a new Blueprint & Catalog
      • Updating a Blueprint
      • Tracking Blueprint Changes
    • Relevant Guides
    • Troubleshooting
  • 🥇Scorecards
    • Overview and Use Cases
    • Usage Guide
      • Creating a Scorecard
      • Updating a Scorecard
      • Evaluating Performance
    • Scorecard Examples
      • Production Readiness Scorecard Example
      • DORA Metrics Scorecard Example
      • Operational Maturity Example
  • 🎨Home Pages
    • Overview and Use Cases
    • Usage Guide
      • Creating a New Tab
  • ⚡Self-Service Actions
    • Overview and Use Cases
    • Usage Guide
      • Configuring your Self Service Agent
      • Managing your Actions Catalog
      • Self-Service Actions as Code
      • Running Actions
      • Tracking Action Runs
  • ↗️Plugins & Automation
    • What happens when you install a Plugin?
    • Self-Hosting Plugins using Galaxy
    • 🤖Automation Rules
      • Overview and Use Cases
      • Usage Guide
        • Creating an Automation Rule
        • Updating an Automation Rule
        • Tracking Automation Changes
        • Managing Automation Suggestion
    • 🔌Plugin Installation Guides
      • ⭐AWS
      • Bitbucket
      • ⭐Flux
      • GitHub
      • GitLab
      • ⭐Google Cloud Platform (GCP)
      • ⭐Kubernetes
      • ⭐OpsGenie
      • ⭐PagerDuty
      • ⭐Snyk
      • ⭐SonarQube
  • 🌐Public API
    • Audit Logs
    • Automations & Self-Service Actions
    • Automation Suggestions
    • Blueprints
    • Dashboards & Views
    • Entities
    • Scorecards
    • Self-Service Action Runs
    • Time Series
    • Users
    • Webhooks
  • ⚙️Invite Users
  • 🛡️Security & Compliance
    • Single Sign-On (SSO)
      • SAML with Google Workspace
      • SAML with Microsoft Entra ID
      • SAML with Okta
      • OIDC with Okta
      • OIDC with Google Workspace
  • 🏥Troubleshooting
  • ❓FAQ
Powered by GitBook
On this page
  • Overview
  • Installation Guide

Was this helpful?

  1. Plugins & Automation
  2. Plugin Installation Guides

Jira

Last updated 7 months ago

Was this helpful?

This plugin is part of Pro and Enterprise plan only

Overview

Jira, by Atlassian, is a widely-used project and issue management platform. When integrated with Rely.io, it can provide additional dimensions of insights, such as customer-facing incidents, security tickets, and ongoing projects. Leveraging Jira data within Rely.io can help in achieving better incident management and project tracking.

Rely.io fetches data directly from Jira, including Projects, Issues, Users, and Groups, ensuring regular synchronization on an hourly basis. Additionally, to achieve real-time data updates, this plugin supports webhooks as outlined in Step 3 of this guide.

Installation Guide

Step 1: Generate a Jira API Token (official docs ).

  1. Log into your Jira Cloud account.

  2. Navigate to Account settings → Security → API tokens.

  3. Click Create and manage API tokens.

  4. Name your token, for example, "Rely.io Integration", and click Create.

  5. Copy and securely store the API token generated.

Step 2: Add Jira to Rely.io Settings

  1. Open Rely.io and navigate to Settings → Data Sources.

  2. Click Add Data Source and choose Jira.

  3. A form will appear for the Jira Cloud integration:

    • Plugin Name: Assign a name for the Jira data source collector.

    • Jira API Token: Paste the token you generated in Step 1.

    • Jira Username Email: Enter the email address associated with the Jira API Token (should match the email used in Jira settings on Step 1.

    • Webhook Token: This token authenticates webhook requests from Jira to Rely.io. If you want to enable webhook implementation, securely store this token for use in Step 3, as you won't be able to view it again in the future. You can also generate a new token and paste it in this field.

Click Create to finalize the integration.

Step 3: Configure Webhooks in Jira

  1. Go to Jira administration → System → Webhooks.

  2. Click Create a Webhook.

  3. Fill in the details:

    • Name: Set a name like "Rely.io Integration Webhook".

    • Secret: Use the webhook token generated in Step 3.

  4. Under Events, select the following checkboxes:

    • Issue related events: Issue created, updated, deleted.

    • User related events: User created, deleted, updated.

    • Project related events: Project created, updated, deleted

  5. Click Create at the bottom of the page.

After you submit your form, an entity discovery run will be kickstarted that can take a few minutes. By the end of this discovery run:

  • New blueprints will be added to your data model

  • Entities representing Jira Projects, Users, Issues and Groups, will be added your software catalog

  • These entities will be hourly updated to ensure they remain in sync with their external counter-parts

  • With webhooks enabled the changes in Jira will be immediately available in your software catalog.

  • Only issues 30 days old will be added to your data model from the moment you setup this integration.

URL: Get the webhook URL from Rely.io. Go to , select the Jira plugin and click "View details". The URL format should be https://magneto.rely.io/api/v1/webhooks/jira?plugin_id=<plugin_identifier>.

↗️
🔌
⭐
here
Rely.io Data Sources