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
$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
:
- Inclua a função em seu manual.
- 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 |
---|---|---|
| Obrigatório | Lista de instalações de destino para execução em hosts. As opções disponíveis são:
|
| Opcional | Valor principal pares de tags passados para a instalação. |
| Opcional | Define o tempo limite para a tarefa de instalação. Substitui o tempo limite padrão de 600s. |
| Opcional | As opções de verbosidade para a instalação ( |
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
requerinfrastructure
e um erro será gerado selogs
for especificado seminfrastructure
.A instalação do agente
apm-nodejs
é compatível apenas com aplicativos gerenciados pelo PM2. Para instalar o agente usando um gerenciador de pacote comonpm
ouyarn
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çosystemd
.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"