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

# Serviços

> O que é monitorado, quem responde por ele e como o alerta encontra o serviço certo.

Um serviço representa algo que é monitorado e que tem dono: `api-pagamentos`, `checkout`, `autenticacao`, `integracao-erp`, `plataforma-mensageria`.

Ele existe por um motivo prático: transformar um alerta técnico em uma responsabilidade humana.

## Criar um serviço

Em **Serviços**, owners e admins definem:

| Campo                 | Para que serve                                                                             |
| --------------------- | ------------------------------------------------------------------------------------------ |
| **Nome**              | Identifica o serviço e é usado no roteamento. Faça-o bater com o que sua ferramenta envia. |
| **Time responsável**  | Decide quem será acionado.                                                                 |
| **Severidade padrão** | Contexto de criticidade quando o alerta não traz severidade reconhecível.                  |

## Como o alerta encontra o serviço

O aciona.me resolve o serviço nesta ordem:

<Steps>
  <Step title="Serviço padrão da fonte de alerta">
    Se a fonte tem um serviço fixo configurado, ele é usado. Útil quando uma ferramenta inteira monitora um único serviço.
  </Step>

  <Step title="Pista de serviço no alerta">
    Cada tipo de fonte extrai a pista de um lugar diferente:

    | Fonte            | De onde vem a pista                                        |
    | ---------------- | ---------------------------------------------------------- |
    | Webhook genérico | campo `service` ou label `service`                         |
    | Prometheus       | labels `service` → `job` → `instance`                      |
    | Grafana          | labels do alerta                                           |
    | Datadog          | tag `service:` → escopo → hostname → métrica               |
    | New Relic        | tag de serviço afetado → entidade → condição → política    |
    | Zabbix           | nome do host                                               |
    | CloudWatch       | dimensão do alarm conforme o namespace, ou o nome do alarm |
  </Step>

  <Step title="Auto-registro">
    Se a pista aponta para um serviço que ainda não existe, o aciona.me pode registrá-lo automaticamente, para que o alerta não se perca.
  </Step>
</Steps>

<Warning>
  Serviços auto-registrados nascem **sem time responsável**. Revise-os periodicamente e vincule ao time correto — até lá, os acionamentos deles ficam sem plantonista.
</Warning>

<Note>
  Serviços auto-registrados não são bloqueados por limite de plano. Essa é uma decisão deliberada: o aciona.me nunca deixa de criar um acionamento por causa de um limite de recurso.
</Note>

## Severidade do serviço

A severidade padrão do serviço é o contexto de criticidade quando o alerta chega sem uma severidade que o aciona.me reconheça. Quando o alerta traz severidade própria, ela prevalece.

As severidades possíveis são `critical`, `high`, `warning` e `info`. Veja como valores de cada ferramenta são convertidos em [Severidades](/pt-br/referencia/severidades).

## Excluir um serviço

Não é possível excluir um serviço com acionamentos abertos. Resolva ou encerre os acionamentos primeiro.

<Columns cols={2}>
  <Card title="Times" icon="users" href="/pt-br/times/visao-geral" horizontal />

  <Card title="Fontes de alerta" icon="webhook" href="/pt-br/fontes-de-alerta/visao-geral" horizontal />
</Columns>