Nossa integração com o Nagios permite que você use suas verificações de serviço diretamente, sem a necessidade de executar uma instância do Nagios.
Continue lendo para instalar a integração e ver quais dados coletamos.
Compatibilidade e requisitos
Nossa integração é compatível com qualquer serviço existente que esteja em conformidade com a API do plug-in Nagios.
Antes de instalar a integração, certifique-se de atender aos seguintes requisitos:
- Instale o agente de infraestrutura.
- Distribuição Linux ou versão do sistema operacional Windows compatível com o agente de infraestrutura da New Relic.
Começo rápido
Instrumente sua instância do Nagios rapidamente e envie seus dados de telemetria com instalação guiada. Nossa instalação guiada cria um comando CLI personalizado para o seu ambiente que baixa e instala a CLI do New Relic e o agente de infraestrutura.
Pronto para começar? Clique em um desses botões para experimentar.
Instalar e ativar
Para instalar a integração do Nagios:
Notas Adicionais:
- Advanced: Também é possível instalar a integração a partir de um arquivo tarball. Isso lhe dá controle total sobre o processo de instalação e configuração.
- On-host integrations do not automatically update. Para obter melhores resultados, atualize regularmente o pacote de integração e o agente de infraestrutura.
Este documento ajudou você na instalação?
Configurar a integração
A configuração no formato YAML de uma integração é onde você pode colocar as credenciais de login necessárias e configurar como os dados são coletados. Quais opções você altera dependem de sua configuração e preferência.
Para obter um exemplo de configuração, consulte os exemplos nagios-config.yml e nagios-service-checks.yml.
Nossos arquivos de configuração possuem configurações comuns usadas em todas as nossas integração, como interval
, timeout
einventory_source
, entre outras. Para obter mais informações sobre essas configurações comuns, consulte esta lista de propriedades de configuração.
Configurações específicas relacionadas ao Nagios são definidas usando a seção env
do arquivo de configuração. Essas configurações controlam a conexão com sua instância do Nagios, bem como outras configurações de segurança e recurso.
Configurações de instância do Nagios
Contexto | Descrição | Padrão |
---|---|---|
SERVICE_CHECKS_CONFIG | Isso aponta para um arquivo yaml contendo definições das verificações de serviço que serão executadas pela integração. Required. | N/A |
CONCURRENCY | O número de verificações de serviço a serem executadas simultaneamente. | 1 |
OUTPUT_TABLE_NAME | O nome da tabela onde os resultados da verificação de serviço são salvos. | NagiosServiceCheckSample |
Arquivo de configuração de verificações de serviço
O arquivo yaml service_checks_config
contém a matriz de nível superior service_checks
. Cada verificação de serviço deve conter um name
e um command
.
Chave | Descrição |
---|---|
| A convenção de nomenclatura não é específica e permite fácil reconhecimento na nossa interface de infraestrutura. |
| O comando é uma matriz de strings, com a primeira posição contendo o caminho para o executável e as posições restantes contendo os argumentos para o executável. |
| Uma coleção de pares de valores principais que ajudam a identificar e agrupar verificações de serviço no New Relic. |
| Tenta analisar a saída das verificações de serviço que estão em conformidade com a especificação da API do plug-in Nagios. Padrão: |
Esses valores de configuração podem ser definidos de diversas maneiras:
- Adicione os valores diretamente no arquivo de configuração.
- Substitua os valores das variáveis de ambiente usando a notação
{{}}
. Isto requer o agente de infraestrutura versão 1.14.0 ou superior. Leia mais aqui. - Use o gerenciamento de segredos para proteger informações confidenciais, como senhas, para que não sejam expostas em texto simples no arquivo de configuração. Para obter mais informações, consulte gerenciamento de segredos.
Etiquetas/atributo personalizado
Variáveis de ambiente podem ser usadas para controlar definições de configuração, como e, em seguida, são passadas para o agente de infraestrutura. Para obter instruções sobre como usar o recurso de passagem, consulte Configurar o agente de infraestrutura.
Você também pode decorar sua métrica com etiquetas. Os rótulos permitem que você adicione atributo de par de valor principal à sua métrica. Você pode usar esses rótulos para consultar, filtrar ou agrupar sua métrica.
Nosso arquivo de configuração de amostra padrão inclui exemplos com rótulos, você pode remover, modificar ou adicionar novos de sua escolha.
labels: env: production role: nagios
Permissões
Comandos não configuráveis são executados pelo agente de infraestrutura, que por sua vez é executado pelo usuário root. Para que a integração seja executada corretamente, certifique-se de que as permissões no arquivo yaml sejam adequadamente restritivas, conforme indicado abaixo:
Exemplo de configuração
Exemplo de configuração de arquivo:
Para obter mais informações sobre a estrutura geral da configuração de integração no host, consulte Configuração.
Encontre e use dados
Para encontrar seus dados de integração, acesse one.newrelic.com > All capabilities > Infrastructure > Third-party services e selecione um dos links de integração do Nagios.
Os dados do Nagios são anexados ao tipo de evento NagiosServiceCheckSample
.
Para saber mais sobre como encontrar e usar seus dados, consulte Compreender os dados de integração.
Dados métricos
O Nagios integração recolhe os seguintes dados métricos atributo.
Métrica de amostra de verificação de serviço Nagios
Esses atributos podem ser encontrados consultando o tipo de evento NagiosServiceCheckSample
.
Métrica | Descrição |
---|---|
| O comando usado para executar a verificação de serviço. |
| A saída de erro padrão (stderr) da verificação de serviço. |
| A parte da mensagem que é analisada pelo Nagios como |
| A saída padrão (stdout) da verificação de serviço. |
| O nome descritivo da verificação de serviço que está sendo executada. |
| A parte da mensagem que é analisada pelo Nagios como |
| O código de retorno da verificação de serviço. Opções:
|
| Qualquer métrica adicional definida e reportada pela verificação do serviço. Ativado somente se |
Resolução de problemas
Dicas de resolução de problemas:
Verifique o código-fonte
Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias, ou criar seu próprio fork e construí-lo.