• /
  • EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

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

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

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.

Importante

Essa função sempre instalará a versão mais recente lançada do agente New Relic e não oferece suporte à instalação de versões mais antigas.

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

bash
$
ansible-galaxy install newrelic.newrelic_install

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

bash
$
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 :

Variável

É necessário

Descrição

targets

Obrigatório

Lista de instalações de destino para execução em hosts. As opções disponíveis são:

  • infrastructure (Linux e Windows)
  • logs (Linux e Windows)
  • apm-php (Linux)
  • apm-nodejs (Linux)
  • apm-dotnet (Linux e Windows)
  • apm-java (Linux)
  • apache (Linux)
  • mssql (Windows)
  • mysql (Linux)
  • nginx (Linux)

tags

Opcional

Valor principal pares de tags passados para a instalação.

install_timeout_seconds

Opcional

Define o tempo limite para a tarefa de instalação. Substitui o tempo limite padrão de 600s.

verbosity

Opcional

As opções de verbosidade para a instalação (debug ou trace) gravam a saída detalhada em um arquivo de log no host.

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.

Nota importante

  • O destino logs requer infrastructure e um erro será gerado se logs for especificado sem infrastructure.

  • A instalação do agente apm-nodejs é compatível apenas com aplicativos gerenciados pelo PM2. Para instalar o agente usando um gerenciador de pacote como npm ou yarn ou através de outros caminhos de instalação, consulte nossos documentos.

  • A instalação do agente apm-dotnet para Windows é compatível apenas com aplicativos hospedados pelo IIS. A instalação do Linux é suportada apenas para aplicativos .NET que são executados como um serviço systemd .

  • A instalação do agente apm-java suporta Java em execução no Tomcat, Wildfly/Jboss e Jetty (independente).

  • As seguintes integrações requerem a instalação do agente de infraestrutura:

    • APM-java
    • apache
    • mssql
    • mysql
    • nginx

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"
Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.