Triggers - AppSignal Documentation

Os comandos triggers gerenciam gatilhos de Anomaly detection: alertas que abrem 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 Anomaly detection 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

Filtre a lista por nome de métrica ou por tags quando estiver revisando um grupo específico de gatilhos:

Shell

appsignal-cli triggers list --app "MyApp" --environment production --metric-name response_time
appsignal-cli triggers list --app "MyApp" --environment production --tag hostname=web-1

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:

Flag	Descriçã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>`	Quantos minutos a métrica deve permanecer acima ou abaixo do limite antes de abrir um alerta
`--cooldown-duration <minutes>`	Quantos minutos a métrica deve permanecer recuperada antes de fechar um alerta

Estas flags são opcionais:

Flag	Descriçã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-zero`	Trata 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 arquiva o gatilho existente e cria um substituto vinculado a ele. Passe a definição completa do gatilho ao atualizar. Comece pelos valores atuais em triggers list, e então altere os campos que quer reajustar:

Shell

appsignal-cli triggers update --id <TRIGGER_ID> --app "MyApp" --environment production \
  --name "Slow web requests" \
  --metric-name response_time --kind Advanced --field mean \
  --comparison-operator ">" --condition-value 750 \
  --warmup-duration 5 --cooldown-duration 2 \
  --notifier-ids <NOTIFIER_ID>

update aceita as mesmas flags que create. Inclua valores opcionais que quer manter, como --notifier-ids, --tag, --dashboard-id e --description.

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 a métrica cruza o limite do gatilho. Inspecione esses incidentes com os comandos de incidentes.

​Listar gatilhos

​Criar um gatilho

​Atualizar um gatilho

​Arquivar um gatilho

​Próximos passos

Listar gatilhos

Criar um gatilho

Atualizar um gatilho

Arquivar um gatilho

Próximos passos