Configure o agente de infraestrutura com Puppet

Aprenda a instalar e configurar nosso agente de infraestrutura, integração de log e agente PHP APM usando o módulo newrelic_installer . Para obter uma explicação de como usar o Puppet, consulte a documentação do Puppet. Este é um esforço apoiado pela comunidade .

Aqui fornecemos informações básicas necessárias para usar esta ferramenta de gerenciamento de configuração. A configuração adicional dependerá dos padrões e da implementação da sua organização.

Requisitos

Nosso módulo Puppet tem estes requisitos:

Puppet Enterprise 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x
Puppet 6.21.0 ou superior, mas inferior a 8.0.0
Debian, CentOS, OpenSUSE, RedHat, SLES, Ubuntu, Windows, Amazon Linux

Descrição do módulo

newrelic-newrelic_installer é um módulo Puppet que o ajudará a dimensionar seus esforços de observabilidade da New Relic. Para conseguir isso, ele usa a CLI do New Relic e nosso repositório de instalação aberto.

Nosso módulo Puppet está disponível no Puppet Forge.

Importante

A instalação de uma versão específica do agente de infraestrutura não é suportada. Este método sempre instalará a versão mais recente do agente.

Instale o agente de infraestrutura com o módulo

Puppet Forge

bash

$puppet module install newrelic-newrelic_installer

Veja mais opções de instalação no PuppetForge

Manual

Instale o kit de desenvolvimento de fantoches: https://www.puppet.com/docs/pdk/2.x/pdk_install.html
Clone o repositório e crie um tarball do módulo usando pdk build. Por exemplo, pkg/newrelic-newrelic_installer-0.1.0.tar.gz
Copie o módulo tarball para o seu nó mestre e instale manualmente:

bash

$sudo puppet module install ~/newrelic-newrelic_installer-0.1.0.tar.gz
$Notice: Preparing to install into /etc/puppetlabs/code/environments/production/modules ...
$Notice: Downloading from https://forgeapi.puppet.com ...
$Notice: Installing -- do not interrupt ...
$/etc/puppetlabs/code/environments/production/modules
$└─┬ newrelic-newrelic_installer (v0.1.0)
$  ├── lwf-remote_file (v1.1.3)
$  └── puppetlabs-powershell (v5.2.0)

Execute o módulo `newrelic-newrelic_installer`

Para executar o módulo newrelic-newrelic_installer padrão, declare a classe ::install principal com o destino da instrumentação e as credenciais da conta New Relic.

# /etc/puppetlabs/code/environments/<YOUR_ENVIRONMENT>/manifests/site.pp
class { 'newrelic_installer::install':
          targets               => ["infrastructure", "logs"],
          environment_variables => {
            "NEW_RELIC_API_KEY"          => "<YOUR-NR-API-KEY>",
            "NEW_RELIC_ACCOUNT_ID"       => <YOUR-NR-ACCOUNT-ID>,
            "NEW_RELIC_REGION"           => "<US|EU>"
          }
}

Parâmetro do Puppet

Aqui estão os parâmetros para a classe pública newrelic_installer::install :

Parâmetro	Tipo	É necessário	Descrição do parâmetro
`targets`	Corda	Obrigatório	Especifica o destino a ser instrumentado com o New Relic. Os valores suportados incluem: `'infrastructure'` - Agente New Relic Infrastructure `'logs'` - integração de log para o agente New Relic Infrastructure . *requer `'infrastructure'` `'php'` - Agente PHP New Relic APM
`environment_variables`	Hash	Obrigatório	Aplique hash de variáveis de ambiente para definir antes da execução. `NEW_RELIC_API_KEY`: sua chave de usuário do New Relic. Required . `NEW_RELIC_ACCOUNT_ID`: seu ID de conta New Relic. Required . `NEW_RELIC_REGION`: a região do seu data center (`US` ou `EU`). O padrão é `US`. `NEW_RELIC_APPLICATION_NAME`: usado por `'php'`. Esta opção de configuração define o nome do aplicativo sob o qual os dados são relatados no APM. O padrão é `'PHP Application'` se não for especificado.
`verbosity`	Corda	Opcional	Especifica o detalhamento da saída do comando Os valores suportados incluem `debug` `trace`
`tags`	Hash	Opcional	Aplicar hash de tag associada à entidade instrumentada com New Relic. Exemplos: `{'key-name' => 'value', 'foo' => 'bar'}`
`proxy`	Corda	Opcional	Define o servidor proxy que o agente deve usar. Exemplos: `https://myproxy.foo.com:8080` `http://10.10.254.254`
`install_timeout_seconds`	Inteiro	Opcional	Define o tempo limite em segundos para instalação New Relic . O padrão é `600`.

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