Configure o agente de infraestrutura usando Ansible

Você pode usar a função Ansible da New Relic para ajudá-lo a dimensionar seus esforços de observabilidade da New Relic usando a CLI da New Relic e o repositório de instalação aberta da New Relic. Para obter instruções sobre como usar o Ansible, consulte a documentação do Ansible. Este é um esforço apoiado pela comunidade .

Quer configurar o agente de infraestrutura usando Ansible? Crie uma conta New Relic gratuitamente! Não é necessário cartão de crédito.

Código de amostra

New Relic fornece código de amostra de gerenciamento de configuração para ajudá-lo a instalar nosso agente de infraestrutura usando fluxo de trabalho e ferramentas comuns a muitas equipes de operações. Esta é uma função básica do Ansible e deve ser usada como ponto de partida para a criação de seu próprio fluxo de trabalho personalizado.

A configuração depende de sua configuração e padrões específicos. Para visualizar um exemplo de função do Ansible e mais informações de integração, consulte a documentação do Ansible Galaxy.

Compatibilidade e requisitos

A função do Ansible como agente de infraestrutura da New Relic requer um sistema operacional compatível.

Se precisar de ajuda com o Ansible para sistema operacional Windows, dê uma olhada em Configurando um host Windows, no site de documentação do Ansible .

Essa função é testada com Ansible Core 2.13 e 2.14 e Python 3.10. Versões do Ansible Core anteriores à 2.10 não são suportadas.

Configure o New Relic com Ansible

instalação

Ansible Galaxy

Link para a Galaxy

$
ansible-galaxy install newrelic.newrelic_install

Certifique-se de ter ansible.windows e ansible.utils se eles ainda não estiverem instalados:

$
ansible-galaxy collection install ansible.windows ansible.utils

Manual

Se você quiser usar uma cópia local da função, clone o repositório e execute make na raiz do projeto para copiar este repositório para ~/.ansible/roles/newrelic.newrelic_install, permitindo que a função se comporte como se tivesse sido instalada do Galaxy.

Começando

Para começar a usar a função newrelic.newrelic_install:

1. Inclua a função em seu manual.
2. Personalize as variáveis necessárias.

Após a instalação, inclua a função newrelic.newrelic_install em um manual novo ou existente. Aqui está um exemplo de configuração de sua função para instalar o agente de infraestrutura:

---
- name: Install New Relic
  hosts: all
  roles:
    - role: newrelic.newrelic_install
      vars:
        targets:
          - infrastructure
          - logs
        tags:
          foo: bar
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>

Variáveis de configuração de função

Aqui estão as variáveis disponíveis para configurar a função newrelic.newrelic_install :

Padrões

Defina em defaults/main.yml:

• cli_install_url
• cli_install_download_location
• target_name_map
• verbosity_on_log_file_path_linux
• verbosity_on_log_file_path_windows
• default_install_timeout_seconds

Variáveis ambientais

Os valores são definidos na palavra-chave environment em seu manual:

• NEW_RELIC_API_KEY (obrigatório)
• NEW_RELIC_ACCOUNT_ID (obrigatório)
• NEW_RELIC_REGION (opcional: 'EUA' ou 'UE', padrão 'EUA')

Além disso, você pode definir uma variável HTTPS_PROXY opcional para ativar um proxy para sua instalação.

Consulte o ambiente remoto do ansible para obter mais informações.

Manual de exemplo adicional

- name: Install New Relic
  hosts: all
  roles:
    - role: newrelic.newrelic_install
      vars:
        targets:
          - infrastructure
          - logs
          - apm-php
        tags:
          foo: bar
        install_timeout_seconds: 1000
        verbosity: debug
  environment:
    NEW_RELIC_API_KEY: <API key>
    NEW_RELIC_ACCOUNT_ID: <Account ID>
    NEW_RELIC_REGION: <Region>
    NEW_RELIC_APPLICATION_NAME: "My Application"
    HTTPS_PROXY: "http://my.proxy:8888"