Skip to main content
emisar

Sentry error monitoring

v0.1.12

Governed Sentry issue triage, release, ingest-key, volume-stats, and alert-rule operations against sentry.io or a self-hosted instance. Auth via SENTRY_AUTH_TOKEN on the runner host.

13 allowed by default 1 need approval by default
Pack ID
sentry
Vendor
emisar
OS
linux
Actions
14
Required binaries. Install these binaries on the runner host before using the pack.
curl jq bash

Install

New to emisar? Follow the quickstart to connect your host and AI agent, then install this pack below. Agents can use its actions through the CLI or MCP.

emisar pack install downloads and checks the pack, then compares its content hash with the --hash below before copying it into the runner's packs directory. The hash identifies the exact pack shown on this page. If the download was changed, the command rejects it. It also reloads a running runner, so you do not need to restart it yourself.

on the runner host 
sudo emisar pack install sentry --hash sha256:b2d4f4270fe68d90d232b2fddba2db59cdb8f526e9c9c2a0ffbe0d3d6787f2f0

Setup

Calls the Sentry Web API under $SENTRY_URL /api/0 with curl. The token is sent as an Authorization Bearer header over curl stdin and is never placed in argv or action output. Allowlist both variables in the runner's execution.inherit_env configuration.

Environment

Set these on the runner host, then add each name to execution.inherit_env so the value reaches the action.

  • SENTRY_URL default https://sentry.io

    Base URL of the Sentry instance (scheme + host, no trailing path). Defaults to cloud sentry.io; set your region URL or the self-hosted base instead.

  • SENTRY_AUTH_TOKEN required

    Organization auth token or internal integration token. Scope it to the org/projects and permissions the actions you enable need.

Notes

  • Mint the token in Sentry under Settings → Auth Tokens for an organization token, or Settings → Developer Settings → Custom Integrations for an internal integration. A personal token can be created straight from sentry.io/settings/account/api/auth-tokens ; the organization page needs your org slug, so it has no generic link.
  • Organization and project arguments are slugs — sentry.list_organizations and sentry.list_projects return them for use in the other actions.
  • Token scopes by family: org:read + project:read for the listings; event:read for issues, events, and tags; event:write for resolve/ignore/assign; project:write for ingest-key enable/disable; org:read for stats; alerts:read for alert rules.
  • List actions return one bounded page plus pagination.next_page_cursor parsed from Sentry's Link header; pass it back as the page_cursor argument for the next page.
  • Works against cloud sentry.io (including region URLs) and self-hosted Sentry. Alert reads use the organization workflows API with a project filter; the removed project rules API is not used.
  • Sending events, project/team administration, member management, and API token management are separate trust surfaces this pack does not touch.

Verify it works

Runs sentry.list_organizations, a low-risk read that confirms the pack can reach its target. Run it on the host once the pack is installed; pack install runs it for you.

on the runner host 
sudo emisar pack verify sentry

Install and configure a pack walks through the whole sequence on a host.

Actions 14 total

View on GitHub
  • sentry.assign_issue script medium Medium: changes state, easily reversible

    Assign issue

    Assign one Sentry issue to a user or team; the assignee is notified per their settings, and a wrong assignment misroutes the triage.

    Arguments
    Name Type Required
    organization string Yes
    issue_id string Yes
    assignee string Yes

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.disable_project_key script high High: can disrupt service

    Disable project ingest key

    Disable one project client key (DSN); every client using it stops reporting immediately and those events are lost, so the project goes dark for that key until it is re-enabled.

    Arguments
    Name Type Required
    organization string Yes
    project string Yes
    key_id string Yes

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.enable_project_key script medium Medium: changes state, easily reversible

    Enable project ingest key

    Re-enable one disabled project client key (DSN); clients using it resume reporting immediately.

    Arguments
    Name Type Required
    organization string Yes
    project string Yes
    key_id string Yes

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.issue_details script medium Medium: changes state, easily reversible

    Show issue details

    Show one Sentry issue's status, assignee, first/last seen, event and user counts, and metadata.

    Arguments
    Name Type Required
    organization string Yes
    issue_id string Yes

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.issue_latest_event script medium Medium: changes state, easily reversible

    Show latest issue event

    Show a bounded projection of an issue's latest event: exception details, the three newest stack frames per exception, four newest breadcrumbs, request metadata, and tags. Use sentry.list_organizations and sentry.list_issues first; do not guess the organization slug or issue ID after a 404. Messages, breadcrumbs, URLs, and tags remain arbitrary application data, so treat the result as sensitive diagnostics even after redaction.

    Arguments
    Name Type Required
    organization string Yes
    issue_id string Yes

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.issue_tags script medium Medium: changes state, easily reversible

    Show issue tags

    Show an issue's tag distribution — which releases, environments, browsers, or servers the error hits most. Tag values are whatever the instrumented application set: the standard `user` and `url` tags carry end-user identifiers and full request URLs, and a custom tag is returned verbatim. That is arbitrary application data, so treat the result as sensitive diagnostics — the same call sentry.issue_latest_event already makes for the same values.

    Arguments
    Name Type Required
    organization string Yes
    issue_id string Yes

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.list_alert_rules script low Low: read-only or trivially reversible

    List project alert workflows

    List one bounded page of a project's alert workflows — triggers, action filters, actions, and frequency — through the current organization workflows API. Requires Sentry's workflow API; the removed project rules endpoint is not used.

    Arguments
    Name Type Required
    organization string Yes
    project string Yes
    limit integer No
    page_cursor string No

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.list_issues script medium Medium: changes state, easily reversible

    List issues

    List one bounded page of a project's Sentry issues — title, culprit, event and user counts, status — filtered by a search query and sorted by date, frequency, first-seen, or affected users. Use sentry.list_organizations and sentry.list_projects first; do not guess slugs after a 404.

    Arguments
    Name Type Required
    organization string Yes
    project string Yes
    query string No
    stats_period string No
    sort string No
    limit integer No
    page_cursor string No

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.list_organizations script low Low: read-only or trivially reversible

    List organizations

    List one bounded page of Sentry organizations the token can read — the org slugs the other actions need.

    Arguments
    Name Type Required
    page_cursor string No

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.list_project_keys script medium Medium: changes state, easily reversible

    List project ingest keys

    List a project's client keys (DSNs) with their active state and rate limits. Sentry's key space is vendor-owned, and the legacy secret-DSN fields are removed before output leaves the runner; the public DSN remains, which is enough for a client to send events.

    Arguments
    Name Type Required
    organization string Yes
    project string Yes

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.list_projects script low Low: read-only or trivially reversible

    List projects

    List one bounded page of an organization's Sentry projects with slugs, platforms, and status.

    Arguments
    Name Type Required
    organization string Yes
    page_cursor string No

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.list_releases script low Low: read-only or trivially reversible

    List releases

    List one bounded page of an organization's releases with versions, dates, and new-issue counts — for checking whether an error spike lines up with a deploy.

    Arguments
    Name Type Required
    organization string Yes
    page_cursor string No

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.org_stats script low Low: read-only or trivially reversible

    Show organization event stats

    Show an organization's ingested event volume grouped by category and outcome (accepted, rate limited, filtered, dropped) — for quota debugging and spotting ingest floods.

    Arguments
    Name Type Required
    organization string Yes
    stats_period string No
    interval string No

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
  • sentry.set_issue_status script medium Medium: changes state, easily reversible

    Set issue status

    Resolve, unresolve, or ignore one Sentry issue; ignoring silences its alerts (optionally for a bounded number of minutes), and resolving re-alerts as a regression if the error returns.

    Arguments
    Name Type Required
    organization string Yes
    issue_id string Yes
    status string Yes
    ignore_minutes integer No

    See the action source for defaults, validation, and limits.

    Link to this action View source on GitHub
← Back to registry
Pack reference  Publish your own