Instalar e configurar NRDOT para monitoramento de MSSQL com Chef

Este cookbook monitora uma ou mais instâncias do SQL Server a partir de um único coletor. Em vez de um único conjunto de host/porta/credencial, ele lê dois arquivos que já devem existir no nó: um arquivo de instâncias (YAML) listando cada instância a ser monitorada, e um arquivo de segredos (KEY=VALUE) com um login de administrador e senha para cada uma, indexado para corresponder.

1. Crie o arquivo de instância no nó. Adicione uma entrada por instância do SQL Server que este coletor deve monitorar, ou apenas uma entrada se estiver executando uma única instância:

   instances:
     - host: localhost
       port: 1433
       login_name: newrelic

   Copiar

2. Crie o arquivo de segredos no nó com um login de administrador e senha para cada instância, indexado para corresponder à ordem do arquivo de instâncias. O login de administrador deve ser um membro da função sysadmin (ou equivalente):

   bash

   Copiar

   $
   NR_CLI_MSSQL_ADMIN_USER_1=<YOUR_ADMIN_USERNAME>
   $
   NR_CLI_MSSQL_ADMIN_PASSWORD_1=<YOUR_ADMIN_PASSWORD>

   default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
   default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
   default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
   default['newrelic_install']['targets'] = [
     'nrdot-collector-mssql'
   ]
   default['newrelic_install']['env']['NR_CLI_MSSQL_CONFIG_PRESET']   = <1 Basic, 2 Advanced, default 1>
   default['newrelic_install']['env']['NR_CLI_MSSQL_INSTANCES_FILE']  = <path to the instances YAML file on the node>
   default['newrelic_install']['env']['NR_CLI_MSSQL_SECRETS_FILE']    = <path to the secrets file (KEY=VALUE per instance) on the node>
   # See all available targets at: https://github.com/newrelic/chef-install

   Copiar

   Atributo (em env )	Descrição	Padrão
   NR_CLI_MSSQL_CONFIG_PRESET	Configuração do NRDOT: 1 para Basic 2 para Advanced	1
   NR_CLI_MSSQL_INSTANCES_FILE	Obrigatório. Caminho para o arquivo YAML de instâncias, já presente no nó.	Nenhum
   NR_CLI_MSSQL_SECRETS_FILE	Obrigatório. Caminho para o arquivo de segredos ( KEY=VALUE , um par de login/senha de administrador por instância), já presente no nó.	Nenhum

   Dica

   Nenhum valor de atributo padrão é fornecido para essas variáveis. Os valores relevantes para o seu destino devem ser definidos explicitamente por meio de default['newrelic_install']['env'][...].

   Dica

   Para monitorar mais de uma instância do SQL Server a partir deste coletor, adicione mais entradas ao arquivo de instância e credenciais numeradas correspondentes (_2, _3,...) ao arquivo de segredos. Uma instância que falha em suas verificações é ignorada com um motivo registrado em log, em vez de abortar toda a instalação.

Este destino é suportado apenas em um host de coletor Windows. Ele usa a autenticação do Windows (integrated security=true) em vez de logins do SQL e monitora uma ou mais instâncias do SQL Server a partir de um único coletor usando um arquivo de instâncias (YAML, host/port por instância, sem arquivo de segredos: uma identidade do Windows monitora cada instância).

Este arquivo já deve existir no nó, com apenas uma entrada se estiver executando uma única instância. Apenas host e port são necessários (sem login_name):

instances:
  - host: sql01.contoso.com
    port: 1433
  - host: sql02.contoso.com
    port: 1433

Para uma instância nomeada, use host mais sua porta TCP estática em vez de host\INSTANCE.

default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
default['newrelic_install']['targets'] = [
  'nrdot-collector-mssql-winauth'
]
default['newrelic_install']['env']['NR_CLI_MSSQL_CONFIG_PRESET']    = <1 Basic, 2 Advanced, default 1>
default['newrelic_install']['env']['NR_CLI_MSSQL_AUTH_MODE']        = <1 for Windows Domain Auth, 2 for gMSA, default 1>
default['newrelic_install']['env']['NR_CLI_MSSQL_WINAUTH_LOCATION'] = <1 for same host as SQL Server, 2 for a different host, default 1; Windows Domain Auth only>
default['newrelic_install']['env']['NR_CLI_MSSQL_INSTANCES_FILE']   = <path to the instances YAML file on the node>
default['newrelic_install']['env']['NR_CLI_MSSQL_WIN_ACCOUNT']      = <Windows domain account, DOMAIN\username; required only for Windows Domain Auth on a different host>
default['newrelic_install']['env']['NR_CLI_MSSQL_WIN_PASSWORD']     = <password for that account; required only for Windows Domain Auth on a different host>
default['newrelic_install']['env']['NR_CLI_MSSQL_GMSA_ACCOUNT']     = <gMSA account, DOMAIN\gMSAName$; gMSA only>
# See all available targets at: https://github.com/newrelic/chef-install

Este cookbook monitora um ou mais endpoints do RDS SQL Server a partir de um único coletor, usando o mesmo padrão de arquivo de instância/arquivo de segredos que o auto-hospedado (ambos os arquivos já devem existir no nó).

1. Crie o arquivo de instâncias no nó, usando o endpoint do RDS como host, com apenas uma entrada se o monitoramento for de apenas uma única instância do RDS:

   instances:
     - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
       port: 1433
       login_name: newrelic

   Copiar

2. Crie o arquivo de segredos no nó com o nome de usuário e a senha mestre do RDS para cada instância, indexado para corresponder à ordem do arquivo de instância:

   bash

   Copiar

   $
   NR_CLI_MSSQL_ADMIN_USER_1=admin
   $
   NR_CLI_MSSQL_ADMIN_PASSWORD_1=YourMasterPassword1

   default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
   default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
   default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
   default['newrelic_install']['targets'] = [
     'nrdot-collector-mssql-rds'
   ]
   default['newrelic_install']['env']['NR_CLI_MSSQL_CONFIG_PRESET']  = <1 Basic, 2 Advanced, default 1>
   default['newrelic_install']['env']['NR_CLI_MSSQL_INSTANCES_FILE'] = <path to the instances YAML file on the node, using RDS endpoints as host>
   default['newrelic_install']['env']['NR_CLI_MSSQL_SECRETS_FILE']   = <path to the secrets file (KEY=VALUE per instance) on the node>
   # See all available targets at: https://github.com/newrelic/chef-install

   Copiar

   Atributo (em env )	Descrição	Padrão
   NR_CLI_MSSQL_CONFIG_PRESET	Configuração do NRDOT: 1 para Basic 2 para Advanced	1
   NR_CLI_MSSQL_INSTANCES_FILE	Obrigatório. Caminho para o arquivo YAML de instância, usando endpoints do RDS como host , já presente no nó.	Nenhum
   NR_CLI_MSSQL_SECRETS_FILE	Obrigatório. Caminho para o arquivo de segredos ( KEY=VALUE , um par de nome de usuário mestre/senha do RDS por instância), já presente no nó.	Nenhum

   Dica

   Nenhum valor de atributo padrão é fornecido para essas variáveis. Os valores relevantes para o seu destino devem ser definidos explicitamente por meio de default['newrelic_install']['env'][...].

   Dica

   Para monitorar mais de um endpoint do RDS SQL Server a partir deste coletor, adicione mais entradas ao arquivo de instância e credenciais numeradas correspondentes ao arquivo de segredos. Uma instância que falha em suas verificações é ignorada com um motivo registrado em log, em vez de abortar toda a instalação.

Este destino é compatível apenas com um host de coletor Windows e exige que suas instâncias do RDS já estejam ingressadas em um domínio do AWS Managed Microsoft AD. Ele monitora um ou mais endpoints do RDS SQL Server a partir de um único coletor usando um arquivo de instâncias (YAML, host/port por instância, usando endpoints do RDS como host). Ao contrário do destino auto-hospedado acima, não há opção de "mesmo host" aqui: uma conta de domínio (ou gMSA) é sempre necessária.

Este arquivo já deve existir no nó, usando cada endpoint do RDS como host, com apenas uma entrada se o monitoramento for de apenas uma única instância do RDS:

instances:
  - host: mydb1.xxxxxxxxxx.us-east-1.rds.amazonaws.com
    port: 1433
  - host: mydb2.xxxxxxxxxx.us-east-1.rds.amazonaws.com
    port: 1433

default['newrelic_install']['NEW_RELIC_API_KEY']    = <API key>
default['newrelic_install']['NEW_RELIC_ACCOUNT_ID'] = <Account ID>
default['newrelic_install']['NEW_RELIC_REGION']     = <Region>
default['newrelic_install']['targets'] = [
  'nrdot-collector-mssql-rds-winauth'
]
default['newrelic_install']['env']['NR_CLI_MSSQL_CONFIG_PRESET']   = <1 Basic, 2 Advanced, default 1>
default['newrelic_install']['env']['NR_CLI_MSSQL_AUTH_MODE']       = <1 for Windows Domain Auth, 2 for gMSA, default 1>
default['newrelic_install']['env']['NR_CLI_MSSQL_INSTANCES_FILE']  = <path to the instances YAML file on the node, using RDS endpoints as host>
default['newrelic_install']['env']['NR_CLI_MSSQL_WIN_ACCOUNT']     = <Windows domain account, DOMAIN\username; Windows Domain Auth only>
default['newrelic_install']['env']['NR_CLI_MSSQL_WIN_PASSWORD']    = <password for that account; Windows Domain Auth only>
default['newrelic_install']['env']['NR_CLI_MSSQL_GMSA_ACCOUNT']    = <gMSA account, DOMAIN\gMSAName$; gMSA only>
# See all available targets at: https://github.com/newrelic/chef-install