> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gatilhos

> Liste, crie, atualize e arquive gatilhos de detecção de anomalias a partir do terminal.

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](/cli/apps).

<Note>
  Estes são gatilhos de detecção de anomalias em métricas. Para gatilhos construídos a partir de linhas de log, veja [Logs](/cli/logs).
</Note>

## Listar gatilhos

```sh Shell theme={null}
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:

```sh Shell theme={null}
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>`   | 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:

| 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 cria uma nova versão vinculada ao gatilho existente:

```sh Shell theme={null}
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:

```sh Shell theme={null}
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](/cli/incidents).