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

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

In the event of any inconsistency between the English version and the translated version, the English versionwill take priority. Please visit this page for more information.

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.