Quando você integra sua conta do OCI para enviar logs para o New Relic, o OCI é sua fonte de dados e o New Relic é o destino. Entre eles, uma função do New Relic (o encaminhador de logs) extrai logs do OCI e os entrega ao New Relic. Se essa função encontrar problemas, por exemplo, um segredo que não consegue ler, um lote que não consegue decodificar ou uma entrega que não consegue concluir, seus logs do OCI param de fluir, mas nada no OCI ou no New Relic informa o motivo.
Para detectar esse tipo de falha antes que custe dados de log a você, o encaminhador de logs pode emitir métricas sobre sua própria integridade. Este documento aborda:
- Habilite as métricas de auto-observabilidade na função do encaminhador de logs, para que ela comece a relatar sinais como contagens de invocação, erros de entrega e atraso no pipeline, o tipo de detalhe que informa onde ocorreu uma falha no pipeline.
- Importe um dashboard pré-criado que transforma esses sinais em gráficos, para que você possa identificar uma anomalia rapidamente em vez de examinar dados brutos de métrica.
Pré-requisitos
Antes de começar, certifique-se de ter:
- A função de encaminhador de logs do OCI que você já implantou com o Resource Manager, o Terraform ou a configuração manual
- O ID da sua conta New Relic, para usar quando você importar o dashboard
Habilite métricas de auto-observabilidade
Nas variáveis de configuração da função de logs, o mesmo local onde você define VAULT_REGION, SECRET_OCID e as outras variáveis de logging, adicione:
FORWARDER_METRICS_TIER: Controla quais métricas de auto-observabilidade o encaminhador emite. Consulte os níveis de métricas para saber o que cada configuração coleta.
Se você configurar a integração com o Resource Manager ou o Terraform, FORWARDER_METRICS_TIER é a única variável que você precisa adicionar — TENANCY_NAME e COMPARTMENT_NAME são resolvidas automaticamente.
Se você configurar a integração manualmente, adicione também:
TENANCY_NAME: identifica sua tenancy do OCI pelo nome de exibição, adicionando tags às métricas do encaminhador para que você possa distinguir as tenancies se monitorar mais de uma.COMPARTMENT_NAME: Identifica, pelo nome de exibição, o compartimento onde você implantou a função de logs, adicionando tags às métricas para detalhamentos por compartimento. Se você implantou no compartimento raiz da tenancy, use o mesmo valor queTENANCY_NAME.
Importante
O New Relic cobra essas métricas de auto-observabilidade na ingestão, da mesma forma que quaisquer outros dados de métrica.
Níveis de métrica
FORWARDER_METRICS_TIER permite que você equilibre a visibilidade em relação ao custo. Ele aceita um dos seguintes valores:
none: Desativa totalmente as métricas de auto-observabilidade.basic(padrão): coleta métricas principais de integridade: contagens de invocação, registros recebidos, entregues e descartados, duração da entrega e atraso no pipeline.advanced: coleta tudo embasic, além de métricas de ajuste mais profundas: volumes de bytes, contagens de erros de decodificação e serialização, comportamento de envio em lote, classes de erros de entrega, duração da execução da função, falhas de busca de segredos e taxa de ocorrência no cache do cliente.
Importe o dashboard de observabilidade
Importante
Defina FORWARDER_METRICS_TIER como basic ou advanced antes de importar o dashboard. Se você o definir como none, o dashboard não terá nenhum dado para mostrar.
Para importar o dashboard:
- Abra o arquivo
oci-log-forwarder-metrics-dashboard-template.jsonno repositóriooci-log-integrationdo GitHub e copie seu conteúdo. - No JSON copiado, localize e substitua todas as ocorrências de
YOUR_ACCOUNT_IDpelo ID da sua conta da New Relic. - Vá para one.newrelic.com > All capabilities > Dashboards.
- No canto superior direito, clique em Import dashboard.
- Cole o JSON editado.
- Escolha a conta e as configurações de permissão para o dashboard e, em seguida, clique em Save.
O dashboard é preenchido após a função de logs processar pelo menos uma invocação com métricas ativadas.
Solucione problemas com o dashboard
Se os logs do OCI pararem de chegar ao New Relic, verifique este dashboard primeiro. Um pico nas falhas de obtenção de segredos ou erros de entrega aponta para um problema no pipeline do encaminhador, como o hub de conectores de serviço, grupos de logs ou função, em vez de no próprio OCI ou New Relic. Depois que você corrigir o problema subjacente, por exemplo, uma política ou permissão do cofre de chaves, os logs são retomados sem reimplantar nada.
Se você não estiver vendo nenhum dado de log e ainda não tiver confirmado que a integração base está funcionando, em vez disso, comece com nossos procedimentos padrão de resolução de problemas de log.
Próximos passos
Continue explorando sua integração do OCI:
- Consulte a lista completa de métricas que a New Relic coleta do OCI.
- Consulte a resolução de problemas gerais da integração do OCI se a própria integração base não estiver funcionando.