Se você estiver enfrentando problemas com a integração do OCI, comece aqui.
Resolução de problemas de logs
Se os seus logs do OCI não aparecerem, pararem inesperadamente, aparecerem como duplicados ou exibirem nomes de recursos incorretamente, comece com a verificação de integridade abaixo e, em seguida, encontre o seu problema específico nas seções a seguir.
Exame de saúde
Essas duas verificações indicam se o problema está a montante na OCI (nada a verificar no New Relic ainda) ou se os logs realmente chegaram ao New Relic:
Verifique o seu conector no OCI. No Console do OCI, vá para Connector Hub e abra o compartimento onde você implantou a sua integração do New Relic. Procure um conector chamado newrelic-logs-<region>-audit (por exemplo, newrelic-logs-us-ashburn-1-audit) e confirme se o status dele é Active. Se você vir um status de erro, abra o conector para obter os detalhes do erro.
Verifique se os logs estão chegando no New Relic. Execute esta consulta em Consulte seus dados:
SELECTcount(*)FROM Log WHERE oracle.loggroupid ='_Audit' SINCE 30 minutes ago
Uma contagem maior que zero significa que os logs de auditoria estão fluindo. Se você estiver realizando a resolução de problemas de um tipo de log diferente, confirme, em vez disso, se há resultados recentes para a janela de tempo relevante.
Se ambas as verificações parecerem saudáveis, é provável que o seu problema seja um dos cenários específicos abaixo, em vez de uma indisponibilidade total.
Associe o que você está vendo à causa provável:
Se você vir isso
Tente isto
Você acabou de concluir a configuração e nada apareceu ainda
Aguarde um pouco. Quando você cria um conector pela primeira vez, o OCI pode levar um tempo para preencher a atividade recente — para logs de auditoria, isso pode levar até 24 horas para eventos históricos, embora novos eventos normalmente apareçam em minutos.
Nenhum conector aparece em Connector Hub
Reabra a sua configuração: se você usou o assistente de configuração guiada, confirme se ativou a opção relevante e execute-o novamente. Se você usou o Terraform, confirme se a sua configuração inclui o conector de logs e aplique-a novamente.
Você tem recursos em mais de uma região do OCI
Confirme se cada região tem o seu próprio conector, se você está verificando a região esperada e repita a configuração para quaisquer regiões adicionais.
A interface do New Relic mostra um erro de acesso/permissão ao carregar compartimentos ou grupos de logs
Abra o conector em Connector Hub e verifique os detalhes do erro. Uma alteração de permissões geralmente causa isso (consulte Permissões ausentes), ou alguém reimplantou ou substituiu a integração subjacente.
O conector está Active, mas nenhum log novo está aparecendo
No OCI Console, acesse Functions e confirme se a função de integração do New Relic está implantada e não apresenta um estado de erro. Se você configurou a observabilidade do encaminhador de logs, verifique esse dashboard primeiro em busca da falha específica, por exemplo, um erro de busca de segredo ou um erro de entrega. Se ainda parecer não saudável e você não conseguir resolver apenas pelo OCI, entre em contato com o suporte.
Alguém alterou recentemente a sua configuração (executou novamente o assistente, alterou uma configuração do Terraform, desativou uma opção)
Execute a configuração novamente com a opção correta habilitada para restaurar o conector — essa alteração provavelmente o removeu ou alterou.
Mais de um conector está enviando o mesmo evento de log para o New Relic. Isso geralmente significa que mais de um conector no OCI está cobrindo os mesmos logs — na maioria das vezes, alguém adicionou um conector mais amplo de "todos os compartimentos" sem remover um conector mais antigo que cobria apenas um único compartimento.
Em Connector Hub, liste todos os conectores relacionados à sua integração do New Relic e verifique o que cada um abrange. Remova qualquer um que se sobreponha, mantendo apenas o conector que abrange o escopo que você realmente deseja.
O escopo do seu conector não abrange tudo o que você esperava.
A configuração abrange
O que está incluído
Toda a tenancy (todos os compartimentos, incluindo os futuros)
Tudo, automaticamente — nenhuma ação é necessária ao adicionar novos compartimentos.
Um compartimento específico e tudo abaixo dele
Esse compartimento e os seus subcompartimentos, incluindo novos subcompartimentos adicionados posteriormente.
Apenas um único compartimento específico
Apenas esse compartimento — ele não inclui automaticamente novos subcompartimentos.
Se você configurou por meio do assistente guiado, o seu conector já abrange toda a tenancy — se ainda faltarem compartimentos, isso indica um problema no conector (consulte Nenhum log é exibido) em vez de um problema de escopo. Se você configurou manualmente ou via Terraform, verifique o escopo configurado para o seu conector e recrie-o com um escopo mais amplo, se necessário.
O New Relic não possui as permissões do OCI de que precisa — isso pode bloquear totalmente a criação do conector ou fazer com que ele seja executado sem a funcionalidade completa.
Solicite ao administrador de locação do OCI que confirme se as seguintes instruções de política existem para o grupo dinâmico criado durante a configuração:
Política
Para que serve
Allow dynamic-group your_dynamic_group_name to read log-content in tenancy
Leitura dos seus dados de log
Allow dynamic-group your_dynamic_group_name to use fn-function in tenancy
Execução da integração do New Relic
Allow dynamic-group your_dynamic_group_name to use fn-invocation in tenancy
Execução da integração do New Relic
Allow dynamic-group your_dynamic_group_name to read secret-bundles in tenancy where any { target.secret.id = 'your_ingest_secret_ocid', target.secret.id = 'your_user_secret_ocid' }
Acessando com segurança sua chave de licença do New Relic
Allow dynamic-group your_dynamic_group_name to inspect dns-family in tenancy
Resolução de nomes amigáveis para recursos de DNS
Allow dynamic-group your_dynamic_group_name to inspect goldengate-family in tenancy
Resolução de nomes amigáveis para recursos do GoldenGate
Allow dynamic-group your_dynamic_group_name to inspect network-firewall-family in tenancy
Resolução de nomes amigáveis para recursos de firewall de rede
Allow dynamic-group your_dynamic_group_name to inspect cloudevents-rules in tenancy
Resolução de nomes amigáveis para recursos de regra de evento
Allow dynamic-group your_dynamic_group_name to inspect integration-instance in tenancy
Resolução de nomes amigáveis para recursos de instância de integração
Se você executar novamente o assistente guiado ou o módulo de política do Terraform, ele os reaplicará automaticamente. Após restaurar as permissões, se o conector ainda não estiver Active, exclua-o e crie-o novamente.
Para alguns tipos de recursos do OCI, o New Relic busca automaticamente um nome legível por humanos (como um nome de VCN ou firewall) logo após o log chegar pela primeira vez, em vez de mostrar o identificador bruto do recurso. Essa busca pode levar alguns minutos na primeira vez que o New Relic vê um determinado recurso.
Se você vir isso
O que ele significa
Um recurso exibe seu ID inicialmente e, logo em seguida, um nome amigável
Normal — isso é esperado na primeira vez que um novo recurso aparece.
Um recurso nunca recebe um nome amigável, mesmo depois de um tempo
Geralmente, trata-se de um problema de permissões — consulte abaixo.
Um tipo de recurso específico nunca mostra um nome amigável para nenhum recurso
Alguns tipos de recursos não têm a pesquisa de nome habilitada e sempre mostrarão seu ID. Este é o comportamento esperado, não um erro.
Se os nomes nunca forem resolvidos, peça ao administrador da sua locação do OCI para confirmar se o grupo dinâmico tem as inspect políticas listadas em Permissões ausentes — uma para cada recurso de DNS, GoldenGate, firewall de rede, regra de evento e instância de integração. Se as permissões parecerem corretas e os nomes ainda não forem resolvidos após uma espera razoável, entre em contato com o suporte com um exemplo do recurso afetado e o timestamp do log.
Se você ativou o dashboard de monitoramento do encaminhador de logs da OCI, use-o como o seu ponto de partida para qualquer coisa além de "os logs estão chegando":
Se você vir isso
O que fazer
Todos os widgets no dashboard estão vazios
Confirme se você ativou a opção de métricas da integração (é uma configuração que você escolhe durante a configuração inicial) e se a função subjacente está em execução no OCI.
A taxa de erros está aumentando no dashboard
Verifique se isso começou logo após uma alteração recente na sua configuração. Se nada foi alterado e o problema persiste, verifique se as regras de rede/firewall do OCI permitem o acesso de saída ao New Relic e confirme se a sua chave de licença do New Relic ainda é válida.
Uma métrica "records dropped" ou semelhante mostra um valor diferente de zero e permanece assim
Entre em contato com o suporte informando o intervalo de tempo — alguns dados de log não estão chegando ao New Relic.
Um bloco exibe um traço ou nenhum valor em vez de um número ou porcentagem
Verifique um intervalo de tempo mais amplo antes de presumir que algo está com problema — isso geralmente é apenas um estado de "ainda não há dados suficientes nesta janela de tempo", não um erro.
Obter mais ajuda
Se você realizou as verificações acima e o problema não foi resolvido, entre em contato com o Suporte do New Relic com:
Qual método de configuração você usou (assistente guiado, configuração manual ou Terraform)
A região da OCI e, se relevante, o(s) compartimento(s) afetado(s)
O intervalo de tempo aproximado em que o problema começou
Referência de métricas do OCI: os namespaces do OCI dos quais o New Relic coleta dados, o serviço ao qual cada um pertence e o tipo de entidade sobre o qual ele relata.
Monitore seu encaminhador de logs do OCI: ative as métricas de auto-observabilidade na função do encaminhador de logs e importe um dashboard para monitorar sua integridade.