acedergren/monitoring-operations

Use ao configurar métricas, alarmes ou solucionar problemas de dados ausentes no Monitoramento OCI. Aborda confusão de namespaces de métricas, peculiaridades de limites de alarmes, configuração de coleta de logs e lacunas comuns de monitoramento.

O que é monitoring-operations?

Esta skill é especializada em operações de monitoramento no Oracle Cloud Infrastructure (OCI). Ela auxilia engenheiros e desenvolvedores a configurar métricas e alarmes, diagnosticar problemas de dados ausentes e entender as peculiaridades do serviço de Monitoramento OCI. A skill cobre tópicos cruciais como confusão entre namespaces de métricas (ex: oci_computeagent vs oci_vcn), armadilhas comuns na definição de limites de alarmes (como intervalos de avaliação e estatísticas), configuração de coleta de logs de recursos e preenchimento de lacunas de monitoramento que frequentemente causam retrabalho. Ela funciona como um guia de referência rápida e boas práticas, compilando o conhecimento adquirido de casos reais e da documentação oficial. É particularmente útil para equipes que gerenciam ambientes OCI e precisam garantir que seus dashboards e alertas estejam corretos e acionáveis, evitando alarmes falsos ou dados omissos que comprometam a observabilidade. A skill fornece orientações claras, baseadas em exemplos práticos, incluindo comandos CLI e configurações de alarmes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/acedergren/oci-agent-skills/tree/main/skills/monitoring-operations

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que monitoring-operations faz?

Use ao configurar métricas, alarmes ou solucionar problemas de dados ausentes no Monitoramento OCI. Aborda confusão de namespaces de métricas, peculiaridades de limites de alarmes, configuração de coleta de logs e lacunas comuns de monitoramento.

Visão Geral

Esta skill fornece orientação prática para trabalhar com o serviço de Monitoramento do Oracle Cloud Infrastructure (OCI). Ela é projetada para ajudar a evitar armadilhas comuns e resolver problemas recorrentes relacionados a métricas e alarmes.

Namespaces de Métricas

Um dos pontos mais confusos no Monitoramento OCI são os namespaces de métricas. Diferentes serviços OCI publicam métricas em namespaces específicos. Por exemplo:

  • oci_computeagent: Métricas do agente de computação (uso de CPU, memória, disco)
  • oci_vcn: Métricas de rede (tráfego, pacotes descartados)
  • oci_blockstore: Métricas de volumes em block storage (IOPS, latência)
  • oci_autonomous_database: Métricas de banco de dados autônomo

Verifique sempre se está consultando o namespace correto. Use o comando CLI para listar namespaces disponíveis:

oci monitoring metric list-namespaces --compartment-id <COMPARTMENT_ID>

Configuração de Alarmes

Limites e Estatísticas

Armadilhas comuns ao configurar alarmes:

  • Intervalo de avaliação: Alarmes usam uma janela de tempo (ex: 5 minutos) para avaliar a métrica. Certifique-se de que o intervalo corresponde ao período de coleta.
  • Estatística: Escolha a estatística correta (média, soma, máximo). Para métricas que representam contagens (como número de erros), use sum.
  • Limiar: Defina um valor que reflita o comportamento esperado. Evite alarmes muito sensíveis que geram falsos positivos.

Exemplo de comando CLI para criar alarme:

ows monitoring alarm create --compartment-id <COMPARTMENT_ID> --display-name "Alta CPU" --metric-compartment-id <COMPARTMENT_ID> --namespace oci_computeagent --query-text "CpuUtilization > 80" --severity WARNING --body "A CPU está acima de 80%"

Solução de Problemas de Dados Ausentes

Se métricas não estão aparecendo:

  1. Verifique agente de monitoramento: O serviço de monitoramento depende do agente OCI estar instalado e em execução nas instâncias.
  2. Permissões IAM: O principal que coleta métricas deve ter permissão para ler métricas no compartimento alvo.
  3. Namespace correto: Confirme se está consultando o namespace esperado.
  4. Período de coleta: Algumas métricas têm latência de alguns minutos. Aguarde o período de coleta.

Use o comando abaixo para verificar a disponibilidade de métricas em um namespace específico:

oci monitoring metric list --compartment-id <COMPARTMENT_ID> --namespace oci_computeagent --all

Coleta de Logs

Para habilitar a coleta de logs de recursos OCI (ex: logs de auditoria, logs de VCN):

  1. No Console OCI, navegue até Logging > Log Groups.
  2. Crie um grupo de logs ou selecione um existente.
  3. Ative logs específicos nos recursos desejados (ex: logs de fluxo de VCN, logs de bucket de objetos).
  4. Use o serviço de Logging Analytics para consultar e analisar logs.

Para configuração via CLI:

oci logging log create --log-group-id <LOG_GROUP_ID> --display-name "MeuLog" --log-type CUSTOM

Lacunas Comuns de Monitoramento

  • Métricas de disco: Em instâncias Windows, o agente de monitoramento pode não expor métricas de disco por padrão. Configure manualmente.
  • Métricas de rede detalhadas: Algumas métricas de rede (como tráfego por interface) podem estar em namespaces separados.
  • Alarmes para recursos efêmeros: Recursos como funções serverless podem não ter métricas contínuas. Ajuste alarmes para tolerar ausência de dados.
  • Métricas de banco de dados: Verifique se o serviço de banco de dados está configurado para publicar métricas no namespace correto.

Referências

Licença

Este skill é fornecido 'no estado em que se encontra' para fins educacionais. Consulte a documentação oficial da Oracle para informações atualizadas.

Habilidades Relacionadas