Integração no host: legado configuração formato

A integração New Relic Infrastructure nenhum host pode usar um dos dois tipos de formatos de configuração. Este documento explica o formato de configuração legado mais antigo.

Importante

A New Relic recomenda usar o novo formato de configuração padrão aprimorado. Para atualizar seu arquivo de configuração para este novo formato, verifique a seção de atualização

Para obter uma introdução à configuração, consulte Visão geral da configuração.

Estrutura do arquivo de configuração

Uma integração no host que usa o formato de configuração padrão requer dois arquivos de configuração:

Um arquivo de definição
Um arquivo de configuração

Arquivo de definição

O arquivo de definição possui um formato de nomenclatura como INTEGRATION_NAME-definition.yml. Este arquivo fornece informações descritivas sobre a integração, tais como: a versão do protocolo JSON que suporta, uma lista de comandos que pode executar e argumentos que aceita. Ele reside neste diretório:

Linux:
```
/var/db/newrelic-infra/newrelic-integrations
```

Windows:

C:\Program Files\New Relic\newrelic-infra\newrelic-integrations

Aqui está um exemplo de arquivo de definição de integração NGINX com duas seções de comando em um sistema Linux:

name: com.myorg.nginx
protocol_version: 2
description: Collect metric and configuration data from NGINX
os: linux
commands:
  metrics:
    command:
      - myorg-nginx
      - --metrics
    interval: 15
  inventory:
    command:
      - myorg-nginx
      - --inventory
    interval: 120
    prefix: integration/myorg-nginx

Um arquivo de definição pode ser dividido em duas partes:

O cabeçalho
A seção de comandos

Cabeçalho do arquivo de definição

Aqui estão as explicações dos elementos de cabeçalho de um arquivo de definição:

Campo de cabeçalho de definição	Descrição
`name`	Obrigatório. Um nome exclusivo `name` para identificar a integração para registro, métrica interna, etc. Quando o agente carrega o arquivo de configuração, o New Relic usa o `name` para procurar a integração no registro do agente.
`protocol_version`	Obrigatório. O número da versão do protocolo. A New Relic usa isso para garantir a compatibilidade entre a integração e o agente. Caso o agente não reconheça a versão de uma integração, ele filtrará essa integração e criará uma mensagem do log. A versão atual do protocolo JSON é `2`. Para obter mais informações sobre alterações de protocolo, consulte Alterações no SDK.
`description`	Opcional. Explicação amigável sobre o que a integração faz.
`os`	Opcional. O sistema operacional onde a integração é executada. New Relic usa isso para filtrar integrações que você pretende rodar apenas em sistemas operacionais específicos. Padrão: execute a integração independentemente do valor `os` . Para restringir a integração a um sistema operacional específico, use uma destas opções: `linux` `windows`

Comandos de arquivo de definição

Após o cabeçalho há uma lista de comandos. A seção de comandos define:

Um ou mais modos operacionais independentes para o executável
Os dados de tempo de execução necessários para que ele seja executado

A seção de comandos é um mapa YAML de definições de comando, onde cada chave é o nome alternativo exclusivo do comando no arquivo de configuração da integração que especifica o executável a ser executado.

Comandos de definição	Descrição
`command`	Obrigatório. A linha de comando real a ser executada como uma matriz YAML de partes de comando. Eles são montados para executar o comando real. Para comandos simples, a matriz pode ser apenas um elemento. Regras de comando adicionais incluem: `command` argumentos: O comando e quaisquer argumentos de linha de comando que são compartilhados para todas as instâncias da integração configuração. `command` execução: O comando será executado no mesmo diretório do arquivo de definição. `command` path: Qualquer comando disponível no `$PATH` do host pode ser usado. Os executáveis localizados no mesmo diretório do arquivo de definição, ou em um subdiretório dele, podem ser executados usando um caminho relativo. Por exemplo: Linux: Para executar um executável chamado `myorg-nginx` no mesmo diretório do arquivo de definição, você pode usar `myorg-nginx` ou `./myorg-nginx`. Os sistemas Linux executarão `myorg-nginx` como se o usuário usasse `./myorg-nginx`. Windows: Para executar um executável chamado `myorg-nginx.exe` no mesmo diretório do arquivo de definição, você pode usar `\myorg-nginx.exe` ou `.\myorg-nginx.exe`. A escrita `myorg-nginx.exe` dos sistemas Windows será executada como se indicasse o caminho atual: `.\myorg-nginx.exe`. Para usar um comando instalado dentro de um diretório no `$PATH` do host, basta usar o nome do comando. Exemplo `python`. Para executar qualquer outro executável que não esteja no `$PATH` do host nem no diretório da integração, use um caminho absoluto para o executável. Exemplo `/opt/jdk/bin/java`. Se o nome do executável fornecido existir no diretório da integração, mas também existir em outro lugar no sistema `$PATH`, a versão no diretório da integração terá precedência.
`interval`	Opcional. O número de segundos entre duas execuções consecutivas do comando, em particular entre o final da execução anterior e o início da próxima execução. Padrão para sondagem métrica: 30 segundos. Mínimo (piso): 15 segundos. Alertas: Para métricas utilizadas para alertas, utilize intervalo de 30 segundos ou menos.
`prefix`	Opcional. A categorização do inventário no formato `category/short_integration_name`. Exemplo `integration/myorg-nginx`. O prefixo não é um caminho específico da plataforma. A barra é o separador correto entre a categoria e `short_integration_name`. O prefixo pode ter no máximo dois níveis. Caso contrário, o inventário não será reportado. Valor padrão se não for definido: `integration/integration_name`.

Comandos de definição

Descrição

command

Obrigatório. A linha de comando real a ser executada como uma matriz YAML de partes de comando. Eles são montados para executar o comando real. Para comandos simples, a matriz pode ser apenas um elemento.

Regras de comando adicionais incluem:

command argumentos: O comando e quaisquer argumentos de linha de comando que são compartilhados para todas as instâncias da integração configuração.
command execução: O comando será executado no mesmo diretório do arquivo de definição.
command path: Qualquer comando disponível no $PATH do host pode ser usado. Os executáveis localizados no mesmo diretório do arquivo de definição, ou em um subdiretório dele, podem ser executados usando um caminho relativo. Por exemplo:
- Linux:
  Para executar um executável chamado myorg-nginx no mesmo diretório do arquivo de definição, você pode usar myorg-nginx ou ./myorg-nginx. Os sistemas Linux executarão myorg-nginx como se o usuário usasse ./myorg-nginx.
- Windows:
  Para executar um executável chamado myorg-nginx.exe no mesmo diretório do arquivo de definição, você pode usar \myorg-nginx.exe ou .\myorg-nginx.exe. A escrita myorg-nginx.exe dos sistemas Windows será executada como se indicasse o caminho atual: .\myorg-nginx.exe.
- Para usar um comando instalado dentro de um diretório no $PATH do host, basta usar o nome do comando. Exemplo python.
- Para executar qualquer outro executável que não esteja no $PATH do host nem no diretório da integração, use um caminho absoluto para o executável. Exemplo /opt/jdk/bin/java.
Se o nome do executável fornecido existir no diretório da integração, mas também existir em outro lugar no sistema $PATH, a versão no diretório da integração terá precedência.

interval

Opcional. O número de segundos entre duas execuções consecutivas do comando, em particular entre o final da execução anterior e o início da próxima execução.

Padrão para sondagem métrica: 30 segundos.
Mínimo (piso): 15 segundos.
Alertas: Para métricas utilizadas para alertas, utilize intervalo de 30 segundos ou menos.

prefix

Opcional. A categorização do inventário no formato category/short_integration_name. Exemplo integration/myorg-nginx.

O prefixo não é um caminho específico da plataforma. A barra é o separador correto entre a categoria e short_integration_name.

O prefixo pode ter no máximo dois níveis. Caso contrário, o inventário não será reportado.

Valor padrão se não for definido: integration/integration_name.

Arquivo de configuração

O arquivo de configuração possui um formato de nomenclatura como INTEGRATION_NAME-config.yml. Este arquivo especifica quais executáveis serão executados e os parâmetros necessários para executá-los. Ele reside neste diretório:

Linux:
```
/etc/newrelic-infra/integrations.d/
```

Windows:

C:\Program Files\New Relic\newrelic-infra\integrations.d

Dica

Recomendamos lintar os arquivos de configuração YAML antes de usá-los para evitar problemas de formatação.

Aqui está um exemplo de arquivo de configuração com uma instância definida. As explicações desses campos são explicadas abaixo do exemplo.

integration_name: com.myorg.nginx
instances:
  - name: nginx1.myorg.com-metrics
    command: metrics
    arguments:
      status_url: http://127.0.0.1/status
    labels:
      environment: production
      role: load_balancer

Outro exemplo de arquivo de configuração com duas instâncias definidas.

integration_name: com.myorg.nginx
instances:
  - name: nginx1.myorg.com-metrics
    command: metrics
    arguments:
      status_url: http://one.url/status
    labels:
      environment: production
      role: load_balancer
 - name: nginx2.myorg.com-metrics
   command: metrics
   arguments:
     status_url: http://another.url/status
   labels:
     environment: production
     role: load_balancer

Definições de campo do arquivo de configuração

Campo do arquivo de configuração	Descrição
`integration_name`	Obrigatório. Este é o cabeçalho e é usado para identificar quais executáveis serão executados. Esse nome deve corresponder exatamente ao nome especificado no arquivo de definição da integração. Recommendation: Para garantir nomes exclusivos, use a notação reversa de nome de domínio.
`name`	Obrigatório. Este é o nome da invocação específica (instância) da integração. Isto é usado para ajudar a identificar qualquer mensagem do log gerada por esta integração e também é útil para resolução de problemas.
`command`	Obrigatório. Este é o comando a ser executado. Deve corresponder exatamente a um dos nomes de alias exclusivos especificados no arquivo de definição da integração.
`arguments`	Opcional. Um objeto YAML onde: Chaves: O nome do argumento. Transformado em maiúsculas quando definido como variável de ambiente. Valores: os valores do argumento. Passado como está. Os argumentos são disponibilizados para uma integração como um conjunto de variáveis de ambiente. Os argumentos no arquivo de configuração não podem ser maiúsculos e devem usar sublinhados para separar palavras.
`labels`	Opcional. Um objeto YAML onde: Chaves: O nome do rótulo. Valores: o valor do rótulo definido.
`integration_user`	Opcional. String com o nome que o agente utilizará para executar o binário de integração. Padrão: depende de `usermode`. Por padrão, a integração é executada com o mesmo usuário que está executando a integração agente, nri-agente para modo privilegiado e não privilegiado e usuário root para modo root. Quando presente, o agente de infraestrutura executará o binário de integração como o usuário especificado. Por exemplo, para executar o binário de integração como usuário root ao executar o agente em um `usermode` diferente de `root`, basta adicionar `integration_user: root` ao arquivo de configuração.

Esta tradução de máquina é fornecida para sua comodidade.