Simple Log Service:Use a SLS Alerting Skill para gerenciar e diagnosticar alertas de forma inteligente

Método 1 (recomendado): Instalar com npx

Antes da instalação, execute os comandos abaixo para confirmar que o Node.js e o npx estão disponíveis localmente:

node -v
npx -v

Se algum dos comandos não for encontrado, instale o Node.js primeiro.

Execute o comando a seguir para instalar a skill:

npx skills add aliyun/alibabacloud-aiops-skills --skill alibabacloud-sls-alerting --full-depth

Selecione o agente de destino e o escopo de instalação conforme solicitado pelo instalador. Após a instalação, confirme que alibabacloud-sls-alerting existe no diretório de skills correspondente e, em seguida, recarregue as skills ou reinicie o agente.

Método 2: Baixar e instalar manualmente

Baixe o pacote alibabacloud-sls-alerting na GitHub Release, extraia-o e copie os arquivos para o diretório de instalação de skills do agente.

Após a cópia, certifique-se de que o diretório alibabacloud-sls-alerting exista no diretório de skills e reinicie o agente para carregar a skill.

Os diretórios de instalação de skills dos agentes mais comuns são:

Aqui, ~ indica o diretório home do usuário. Os diretórios de workspace e de nível de usuário do OpenClaw podem ser ajustados via configuração. Para mais informações, consulte a documentação do OpenClaw Skills.

(Recomendado) Instale alibabacloud-sls-query junto com a skill de alertas. A skill de consulta ajuda a gerar e otimizar instruções de consulta de alertas, além de auxiliar no diagnóstico de eventos de alerta consultando e analisando os logs relacionados.

Melhores práticas de prompt

Ao criar ou modificar uma regra de monitoramento de alerta, forneça as seguintes informações:

Para diagnosticar um evento de alerta, informe o projeto ao qual a regra de monitoramento pertence, o id da regra, o intervalo de tempo do evento e o fuso horário. Caso os logs estejam arquivados em outro local, forneça também o projeto de arquivamento, o LogStore e o campo de tempo.

A frequência de verificação e a janela de tempo da consulta controlam comportamentos diferentes. Especifique ambos explicitamente no prompt:

Por exemplo, "verificar os dados dos últimos 5 minutos a cada minuto" significa que uma verificação ocorre uma vez a cada 1 minuto, e cada verificação utiliza os logs dos últimos 5 minutos.

Cenário 1: Criar uma regra de monitoramento de alerta

Prompt

Create an SLS alert monitoring rule with the ID web-500-alert in prod-web in the cn-hangzhou region.
Check the access logs of the last 5 minutes in nginx-access every minute, and fire an alert when the number of requests with status 500 reaches 100.
Send the alert notification by email to the existing recipient web-ops@example.com.

Exemplo de saída do agente

Query statement:
status : 500 | SELECT count(*) AS errorCount FROM log

Alert monitoring rule configuration:
- Alert monitoring rule ID: web-500-alert
- Data source: prod-web/nginx-access
- Check frequency: 1 minute
- Query window: the last 5 minutes
- Trigger condition: errorCount >= 100
- Alert notification: email, web-ops@example.com

Configuration result: the alert monitoring rule is created. The trigger condition and the email notification configuration are verified.

Cenário 2: Alterar a condição de acionamento de uma regra de monitoramento de alerta existente

Prompt

Modify the SLS alert monitoring rule web-500-alert in prod-web in the cn-hangzhou region.
Change the alert threshold for the number of requests with status code 500 from 100 to 200, and keep the other settings unchanged.

Exemplo de saída do agente

Update result: the alert monitoring rule is updated. The alert threshold is verified as 200, and the other settings remain unchanged.

Cenário 3: Configurar notificações por e-mail e SMS

Prompt

Add an SLS alert notification recipient with the name xxx, the email address xxx@example.com, and the mobile number xxx.
Then add email and SMS notifications for the alert monitoring rule web-500-alert in prod-web in the cn-hangzhou region,
and send both to this recipient.

Exemplo de saída do agente

Alert notification recipient added:
- Name: xxx
- Email: xxx@example.com
- Mobile number: xxx

Alert notification configuration:
- Alert monitoring rule: prod-web/web-500-alert
- Recipient: xxx
- Notification channels: email, SMS

Configuration result: email and SMS notifications for this recipient are added to the alert monitoring rule. The recipient information and the channel configuration are verified.

Cenário 4: Analisar por que um alerta disparou e quanto tempo durou

Prompt

The SLS alert monitoring rule web-500-alert in prod-web fired several times this morning. Investigate the cause.

Exemplo de saída do agente

Event range: 2026-09-10 09:00-10:00, Beijing time (UTC+8).
Alert monitoring rule: prod-web/web-500-alert.

Trigger cause:
- The history shows that the trigger condition at that time was errorCount >= 100.
- The execution record at 09:10 used the source log window 09:05-09:10, and errorCount was 186.
- The source logs of that window were queried again. The statistics match the record and meet the trigger condition at that time.

Frequency and duration:
- After deduplication by execution ID, 6 executions between 09:10 and 09:15 were in the firing state.
- These executions belong to 1 continuous alert.
- A recovery record exists at 09:16. The time from the first firing to recovery was about 6 minutes.
- The number of firing executions is not equal to the number of notifications. The actual delivery is subject to the notification records.

Source log evidence:
- Executed query: status : 500 | SELECT count(*) AS errorCount FROM log
- Query window: 09:05-09:10, returned errorCount=186.
- After drill-down by request_uri, /api/order/create accounts for 142 hits, about 76.3%.
- The error logs of this API contain upstream connect timeout.

Conclusion: the alert fired because the number of requests with status code 500 reached the threshold. The errors are concentrated on /api/order/create.
Next steps: check the upstream connection status and the service logs. The current evidence is not enough to confirm the underlying cause of the timeout.

Neste exemplo, os logs de source fazem parte das evidências utilizadas no diagnóstico.

Cenário 5: Silenciar temporariamente notificações de alerta

Prompt

Temporarily silence the SLS alert notifications of web-500-alert in prod-web for 30 minutes.

Exemplo de saída do agente

Temporary silence is set:
- Alert monitoring rule: prod-web/web-500-alert
- Duration: 30 minutes from now
- Scope: the alert notifications generated by this alert monitoring rule

The alert monitoring rule continues to run checks, and alert notifications are paused during the silence period.
The silence ends automatically after 30 minutes, and subsequent notifications follow the original configuration.

Preciso instalar o Alibaba Cloud CLI e o plugin SLS manualmente?

O agente verifica o ambiente antes de executar uma operação e fornece orientações de instalação ou atualização quando um componente está ausente ou a versão não atende aos requisitos. Para verificar ou atualizar o ambiente manualmente, consulte Alibaba Cloud CLI or SLS plugin is missing or outdated.

Como especifico uma conta da Alibaba Cloud ou uma região?

O profile configurado atualmente no Alibaba Cloud CLI é usado por padrão. Para usar outro profile, especifique seu nome explicitamente no prompt, por exemplo, "Use Profile=prod para gerenciar as regras de monitoramento de alerta de prod-web em cn-hangzhou."

O projeto ao qual a regra de monitoramento de alerta pertence, a fonte de dados da consulta e o histórico de alertas podem estar em regiões diferentes. Forneça ou verifique cada um deles separadamente. Para acessar via rede interna, solicite explicitamente o endpoint interno da mesma região correspondente, por exemplo, cn-hangzhou-intranet.log.aliyuncs.com.

Posso consultar dados entre projetos, regiões ou contas?

O projeto ao qual a regra de monitoramento de alerta pertence e a fonte de dados da consulta podem ser diferentes. Especifique o projeto, o LogStore e a região da fonte de dados, e certifique-se de que as permissões correspondentes foram concedidas.

Consultas entre contas também exigem uma função RAM que o SLS possa assumir, sua relação de confiança e permissões de acesso aos dados de source. O configurador também pode precisar da permissão ram:PassRole. Uma consulta manual bem-sucedida via CLI não significa que a identidade de execução da regra de monitoramento de alerta já possua permissões de acesso.

O agente não reconhece a skill após a instalação

Confirme se a skill está instalada no diretório que o agente atual realmente carrega e se o diretório contém SKILL.md, references e scripts. Verifique se a instalação no nível do projeto corresponde ao diretório de trabalho atual e, em seguida, recarregue as skills ou reinicie o agente. Você também pode especificar alibabacloud-sls-alerting explicitamente no prompt.

O Alibaba Cloud CLI ou o plugin SLS está ausente ou desatualizado

Verifique o Alibaba Cloud CLI e o plugin SLS no seu terminal:

aliyun version
aliyun sls version

Se o plugin SLS estiver ausente, execute o seguinte comando:

aliyun plugin install --names sls

Caso o plugin esteja instalado, mas o comando ou parâmetro necessário não esteja disponível, execute o comando abaixo:

aliyun plugin update --name sls

Erros de não autorizado ou AccessDenied

Verifique a autorização RAM com base na Action e no Resource da requisição com falha. Diferentes operações exigem permissões distintas:

Os itens acima são exemplos de nomes de permissões, não uma política de autorização completa. Configure o escopo de recursos suportado com base na operação real. Se uma Action do tipo Job aparecer na mensagem de negação, solucione o problema com base na Action real em vez de determinar as permissões necessárias apenas pelo nome da API.

O erro ProjectNotExist

Verifique o nome do projeto, sua região e o endpoint. O projeto ao qual a regra de monitoramento de alerta pertence e o projeto da fonte de dados da consulta podem ser diferentes, portanto, confirme qual requisição falhou. Não considere um resultado "não encontrado" na região errada como prova de que o recurso não existe.

O erro IndexConfigNotExist ou campos que não podem ser analisados

Confirme se um índice está configurado para o LogStore de destino e se os tipos de campo e as configurações de análise SQL usadas pela consulta estão corretos. Por exemplo, cálculos de latência média devem usar um campo numérico, e a unidade deve ser verificada. Após ajustar o índice, revalide a consulta dentro do escopo efetivo do índice.

Uma regra de monitoramento de alerta foi criada, mas nenhuma notificação chega

Solucione o problema na seguinte ordem:

1. Verifique se a regra de monitoramento de alerta está ativada e se registros de execução normais estão sendo gerados.

2. Analise a janela de consulta real, o resultado retornado, a condição de acionamento e o limiar de acionamentos contínuos para confirmar se um evento de alerta foi gerado.

3. Confirme se a saída de notificação do SLS está ativada e se a política de alerta e a política de ação associadas à regra de monitoramento de alerta estão corretas.

4. Verifique se o intervalo de repetição, silêncio, supressão, ramificação condicional ou o período de envio estão tendo efeito.

5. Revise o status do destinatário, as opções de canal, o conteúdo do modelo e as configurações de webhook e, em seguida, analise os registros de erro de notificação. Uma configuração bem-sucedida e uma entrega real de notificação devem ser verificadas separadamente.

O diagnóstico de evento de alerta não encontra o histórico de alertas

Primeiro, confirme o intervalo de tempo, o fuso horário, o id da regra de monitoramento de alerta, a região onde o histórico está armazenado e as permissões de acesso.

O histórico do Alert Center geralmente é armazenado em internal-alert-center-log sob sls-alert-<account ID>-<region>. O histórico de execução do projeto é armazenado em internal-alert-history no projeto ao qual a regra de monitoramento de alerta pertence. Ambos possuem campos e finalidades diferentes. Para mais informações, consulte Use custom query statements to analyze alert logs.

No primeiro uso do Alert Center, conclua a seleção da Region no console SLS. O histórico de execução do projeto é ativado ao acessar a página de detalhes da regra de monitoramento de alerta correspondente no console pela primeira vez. Para obter informações sobre como visualizar detalhes da regra de monitoramento de alerta e relatórios estatísticos históricos, consulte Manage an alert monitoring rule.