Listar issues en Sentry, con una API
Lista las issues de una organización, por defecto las no resueltas ordenadas por última aparición. Cada issue trae id, shortId, title, status, level, conteo de eventos, conteo de usuarios, primera y última aparición y proyecto. Devuelve hasta 100; afina con query, project y statsPeriod.
- Identificador
- sentry_list_issues
La llamada
POST https://connect.reportei.com/api/tools/sentry_list_issues/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"organization_id_or_slug": "<organization_id_or_slug>"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| organization_id_or_slug | string | Sí | Slug or id of the organization, from List organizations. |
| query | string | No | Search in Sentry syntax, such as is:unresolved level:error firstSeen:-24h. Defaults to is:unresolved; send an empty text for every issue. |
| project | array | No | Ids or slugs of the projects to keep, from List projects. Omit it for every project the token reaches. |
| environment | array | No | Names of the environments to keep, such as production. |
| statsPeriod | string | No | Relative period, such as 24h, 14d or 2w. It overrides start and end. |
| start | string | No | Start of the period, in ISO 8601. |
| end | string | No | End of the period, in ISO 8601. |
| sort | string | No | Order: date is last seen, new is first seen, freq is events, user is users affected. Defaults to date.Valores: date, new, trends, freq, user, inbox, recommended |
| shortIdLookup | string | No | Set to 1 to find an issue by the short id shown in Sentry, such as PROJECT-1A2, sent in query. The other filters are then ignored.Valores: 0, 1 |
| limit | integer | No | Issues to return, up to 100. |
Conexiones posibles
Tu cliente conecta su cuenta de Sentry una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
Al conectar, tu cliente también indica {region}: la dirección de su cuenta en la API de la app.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/sentry_list_issues. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Sentry
- Listar organizacionesGETLista las organizaciones a las que llega el token en esta ubicación de almacenamiento de datos, cada una con id, slug y name. El slug es el organization_id_or_slug que piden las demás herramientas. Devuelve hasta 100.
- Listar proyectosGETLista los proyectos de una organización, cada uno con id, slug, name y platform. El slug es el project_id_or_slug que piden las herramientas de proyecto. Devuelve hasta 100; afina con query.
- Obtener proyectoGETDevuelve un proyecto con name, platform, equipos, estado y ajustes.
- Obtener issueGETDevuelve una issue con title, culprit, status, level, responsable, conteos, primera y última aparición, release y principales etiquetas.
- Actualizar issuePUTResuelve, archiva, reabre, asigna o cambia la prioridad de una issue. Solo cambian los campos enviados. Para archivar, envía status ignored con un substatus, y la condición en statusDetails cuando sea archived_until_condition_met.
- Listar eventos de la issueGETLista los eventos de una issue, 100 por página. Con full true cada evento trae el stack trace, y la página baja a 10.
- Obtener evento de la issueGETDevuelve un evento de una issue con stack trace, etiquetas, contexto, breadcrumbs y request. Usa latest, oldest o recommended como event_id cuando no tengas un id de evento.
- Obtener etiqueta de la issueGETDevuelve los valores más frecuentes de una etiqueta en los eventos de una issue, con el conteo de cada uno, como los navegadores o releases afectados.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
