Octri

Jira

Open Jira Cloud issues in a project from monitoring errors and docs feedback.

What you need

Jira Cloud only: a site on atlassian.net. Self-managed Jira Server and Data Center aren't supported. Create an API token at id.atlassian.com, under Security, for the account issues are opened as.

Connect it

  1. Open Integrations

    Open Integrations in the project sidebar and choose Jira under Issue tracking.

  2. Fill in the details

    Fill in the site, the account's email, the project key, the issue type and the API token.

  3. Press Connect

    Octri checks the details with Jira before it saves, and says what's wrong if Jira refuses them.

Settings

SiteURLrequired

Your Jira Cloud address, such as https://acme.atlassian.net.

Account emailemailrequired

The Atlassian account the API token belongs to.

Project keystringrequired

The key of the project issues open in, such as ENG: a capital letter, then capitals, digits or underscores.

Issue typestringdefault: Bug

The issue type to create, by its name in that project, such as Bug or Task.

API tokensecretrequired

The account's API token.

Keys and tokens are stored encrypted and never shown again: the card shows only a masked preview. To change another field later, leave the secret empty and the saved one is kept.

From a monitoring issue

Open an issue in Monitoring, on the Issues tab, and press Create issue. If several trackers are connected, pick one first. Octri opens one Jira issue per monitoring issue: after that, the button is a link to it, labelled with its key, such as ENG-42.

The issue is titled with the error, and says:

  • how many times it was seen, by how many users, and when first and last
  • the endpoint, as method and path, when there is one
  • the culprit, when there is one
  • a link back to the project's issues in Octri
  • the last stack trace, as a code block. The summary is cut to Jira's 255 characters

From docs feedback

Turn on Send docs feedback here on the Jira card to collect what readers say about your docs. With page feedback on, a reader who votes No is asked what was missing. The first comment on a page opens a issue titled Docs feedback: <page>, and later comments on that page are added to it, so each page collects its feedback in one place.

Octri passes each comment on and doesn't keep it. Votes are counted in Octri either way.

When it refuses

If Jira turns the credentials down, the message says so with the HTTP status it answered. Check the token still works and can see the project. Jira is given ten seconds to answer.

Disconnect

Press Disconnect on the card. Jira issues already opened stay where they are. If Jira was receiving docs feedback, readers' comments stop being asked for until another tracker takes it.

Connecting and changing trackers needs permission to edit project settings. Opening an issue from monitoring needs permission to edit monitoring. See organizations and roles.