Pular para o conteúdo principal
Os comandos triggers gerenciam gatilhos de detecção de anomalias: alertas que disparam quando uma métrica cruza um limite que você definiu. Cada comando direciona uma aplicação, por nome e ambiente (--app "MyApp" --environment production) ou por ID (--app-id <APP_ID>, o ID hexadecimal longo da aplicação obtido em appsignal-cli apps list). A flag --environment só é necessária quando várias aplicações compartilham um nome, e cada comando usa sua organização padrão, a menos que você passe --org. Veja Aplicações e organizações.
Estes são gatilhos de detecção de anomalias em métricas. Para gatilhos construídos a partir de linhas de log, veja Logs.

​
Listar gatilhos

Shell
appsignal-cli triggers list --app "MyApp" --environment production

​
Criar um gatilho

Um gatilho observa um campo de métrica e abre um alerta quando ele cruza um limite:
Shell
appsignal-cli triggers create --app "MyApp" --environment production \
  --name "Slow web requests" \
  --metric-name response_time --kind Advanced --field mean \
  --comparison-operator ">" --condition-value 500 \
  --warmup-duration 5 --cooldown-duration 2 \
  --description "Alert when mean response time stays above 500ms"
Estas flags são obrigatórias:
FlagDescrição
--metric-name <name>A métrica a monitorar
--kind <kind>Tipo de gatilho, ex.: Advanced, Performance ou HostCPUUsage
--field <field>Campo a comparar: count, counter, gauge, mean, p90 ou p95
--comparison-operator <op>Um de >, >=, <, <=, == ou !=
--condition-value <number>Limite com o qual comparar
--warmup-duration <minutes>Por quanto tempo a condição deve se manter antes de abrir um alerta
--cooldown-duration <minutes>Por quanto tempo deve se recuperar antes de fechar um alerta
Estas flags são opcionais:
FlagDescrição
--name <text>Nome de exibição (padrão é o nome da métrica)
--description <text>Descrição mostrada com o gatilho
--notifier-ids <list>IDs de notificadores separados por vírgula para anexar
--tag <key=value>Filtro de tag (repita a flag, ou separe por vírgula)
--dashboard-id <id>Dashboard para vincular a partir das notificações
--no-match-is-zeroTrata pontos de dados ausentes como 0
--format <format>Formato do valor, ex.: duration, number ou percent
--format-input <unit>Unidade de entrada para formatos de tamanho, ex.: byte ou kilobyte

​
Atualizar um gatilho

Atualize um gatilho pelo seu --id (de triggers list). Uma atualização cria uma nova versão vinculada ao gatilho existente:
Shell
appsignal-cli triggers update --id <TRIGGER_ID> --app "MyApp" --environment production \
  --condition-value 750
update aceita as mesmas flags que create.

​
Arquivar um gatilho

Arquivar um gatilho também fecha seus alertas e incidentes associados:
Shell
appsignal-cli triggers archive --id <TRIGGER_ID> --app "MyApp" --environment production

​
Próximos passos

Um gatilho abre um incidente quando dispara. Inspecione-os com os comandos de incidentes.