Skip to main content

Documentation Index

Fetch the complete documentation index at: https://opensre.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

OpenSRE connects to Jira to create incident tickets, update existing issues, and add investigation findings as comments — keeping your team’s workflow in sync with automated investigations.

​
Prerequisites

  • Jira Cloud account (Jira Server/Data Center also supported)
  • API token and project access

​
Setup

​
Option 1: Interactive CLI

opensre integrations setup
Select Jira when prompted and provide your base URL, email, API token, and project key.

​
Option 2: Persistent store

Add to ~/.config/opensre/integrations.json: 
{
  "version": 1,
  "integrations": [
    {
      "id": "jira-prod",
      "service": "jira",
      "status": "active",
      "credentials": {
        "base_url": "https://your-org.atlassian.net",
        "email": "you@example.com",
        "api_token": "your-api-token",
        "project_key": "OPS"
      }
    }
  ]
}
FieldDescription
base_urlRequired. Your Jira instance URL (e.g., https://your-org.atlassian.net)
emailRequired. Email address associated with the API token
api_tokenRequired. Jira API token
project_keyRequired. Default project key for new issues (e.g., OPS, SRE)

​
Creating a Jira API token

  1. Go to id.atlassian.com/manage-profile/security/api-tokens
  2. Click Create API token
  3. Give it a label (e.g., opensre)
  4. Copy the token
For Jira Data Center/Server, use a personal access token from Profile → Personal Access Tokens instead.

​
Troubleshooting

SymptomFix
401 UnauthorizedCheck email and API token combination
404 Not FoundVerify base_url (include https://) and project_key
403 ForbiddenThe user may lack permission to create issues in the project

​
Security best practices

  • Use a dedicated Jira user for OpenSRE with only the permissions it needs (create and comment on issues).
  • Store credentials in ~/.config/opensre/integrations.json, not in source code or environment variables.
  • Rotate the API token periodically.