Notre avis

Cet outil permet de récupérer et d'analyser les incidents d'erreur depuis AppSignal via l'interface en ligne de commande.

Points forts

Accès rapide aux incidents et échantillons d'erreur sans ouvrir l'interface web.
Filtres variés (état, namespace, date, occurrences) pour affiner les recherches.
Export en markdown pour partager les rapports d'erreur facilement.

Limites

Nécessite une configuration préalable (token et ID d'application).
Dépend de la complétude des données remontées par AppSignal.
Fonctionnalités limitées par rapport à l'interface web complète.

Quand l'utiliser

Utilisez cette compétence lorsque vous devez investiguer des erreurs en production listées dans AppSignal, analyser leur backtrace et proposer un correctif.

Quand l'éviter

Évitez de l'utiliser pour des investigations qui nécessitent des métriques de performance ou des données agrégées non disponibles via la CLI.

Exemples

List open incidents

List all open AppSignal incidents for the web namespace with at least 5 occurrences, then get details on the most recent one.

Debug recent error sample

Fetch the latest 5 error samples from AppSignal and get full details of the first one including params and session data.

Export incident as report

Export AppSignal incident #42 to a markdown file and summarize the backtrace.

name: appsignal description: Fetch and analyze AppSignal error incidents. Use when debugging errors, investigating exceptions, or when the user mentions AppSignal, incidents, or error monitoring. argument-hint: "[incidents|samples] [command] [options]" allowed-tools: Bash(appsignal-cli *)

AppSignal CLI

Name: Analyse d'erreurs AppSignal
Author: Skills Guide Bot

Use the appsignal-cli CLI to fetch error incidents and samples from AppSignal for debugging and analysis.

Prerequisites

Ensure APPSIGNAL_TOKEN and APPSIGNAL_APP_ID environment variables are set, or a .appsignal-cli.yaml config file exists.

Common Workflows

Investigate Recent Errors

# List open incidents
appsignal-cli incidents list

# Get details for a specific incident
appsignal-cli incidents get <number>

Filter Incidents

# By state: open, closed, wip
appsignal-cli incidents list --state open

# By namespace: web, background, frontend
appsignal-cli incidents list --namespace web

# By date (ISO 8601)
appsignal-cli incidents list --since 2024-01-15

# By minimum occurrences
appsignal-cli incidents list --min-occurrences 10

# Combine filters
appsignal-cli incidents list --namespace background --min-occurrences 5

Get Detailed Error Information

# Standard detail view
appsignal-cli incidents get <number>

# With params and session data
appsignal-cli --verbose incidents get <number>

# Export as markdown for analysis
appsignal-cli incidents export <number> -o error-report.md

Work with Error Samples

# List recent error samples
appsignal-cli samples list --limit 10

# Get full sample details (params, session, environment)
appsignal-cli samples get <sample-id>

Manage Incidents

# Close a resolved incident
appsignal-cli incidents close <number>

# Reopen if issue recurs
appsignal-cli incidents reopen <number>

Output Formats

Use --compact for token-efficient output when analyzing errors:

appsignal-cli --compact incidents list
appsignal-cli --compact incidents get <number>

Use --json for structured data:

appsignal-cli --json incidents list

Debugging Steps

When asked to debug an AppSignal error:

List incidents to find the relevant error
Get incident details including backtrace
Analyze the backtrace to identify the root cause
Find the relevant code in the codebase
Propose a fix based on the error context

Available Commands

| Command | Description | |---------|-------------| | apps | List all applications | | incidents list | List error incidents | | incidents get <n> | Get incident details | | incidents close <n> | Close an incident | | incidents reopen <n> | Reopen an incident | | incidents export <n> | Export to markdown | | samples list | List error samples | | samples get <id> | Get sample details | | config show | Show current config | | config init | Initialize config file | | config set <k> <v> | Set config value |

Analyse d'erreurs AppSignal

Recommandé pour