Instale e configure o NRDOT para monitoramento do MSSQL com a CLI

Esta receita monitora uma ou mais instâncias do SQL Server a partir de um único coletor. Em vez de solicitar um único conjunto de host/porta/credencial, ele lê dois arquivos criados antecipadamente: um arquivo de instâncias (YAML) que lista cada instância a ser monitorada e um arquivo de segredos (KEY=VALUE) com um login e senha de administrador para cada uma, indexados para corresponder.

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

   bash

   Copiar

   $
   cat > ~/mssql-instances.yml << 'EOF'
   $
   instances:
   $
     - host: localhost
   $
       port: 1433
   $
       login_name: newrelic
   $
   EOF

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

   bash

   Copiar

   $
   umask 077
   $
   cat > ~/mssql-secrets.env << 'EOF'
   $
   NR_CLI_MSSQL_ADMIN_USER_1=<YOUR_ADMIN_USERNAME>
   $
   NR_CLI_MSSQL_ADMIN_PASSWORD_1=<YOUR_ADMIN_PASSWORD>
   $
   EOF
   $
   chmod 600 ~/mssql-secrets.env

   Linux:

   bash

   Copiar

   $
   curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-mssql

   Windows (executar em uma sessão do PowerShell de administrador):

   [Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql

   Copiar

   A CLI exibe prompts interativamente para as seguintes variáveis. Você também pode defini-las antecipadamente como variáveis de ambiente para executar de forma não interativa.

   Variável	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.	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).	Nenhum

   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. A instalação só falha totalmente se nenhuma das instâncias passar.

Este método é 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. O coletor é um serviço do Windows com uma conta de logon, e se conecta a cada instância como essa conta, portanto, uma instalação de múltiplas instâncias sempre usa um modo de autenticação e uma identidade do Windows, concedida em cada instância listada.

1. Crie o arquivo de instâncias. Adicione uma entrada por instância do SQL Server a ser monitorada por este coletor, ou apenas uma entrada se estiver executando uma única instância. Apenas host e port são necessários (sem login_name, sem arquivo de segredos):

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

   Copiar

   Salve isto em qualquer lugar no host do coletor, por exemplo, C:\mssql-instances.yml. Para uma instância nomeada, use host mais sua porta TCP estática em vez de host\INSTANCE.

   Antes de executar este comando, tenha em mãos:

• O arquivo de instâncias da etapa 1

• Seja usando uma conta do Windows ou uma conta gMSA

• Para Autenticação do Windows: se o coletor é executado no mesmo host que o SQL Server ou em um host diferente

• A conta do Windows (ou conta gMSA) à qual conceder permissões (não é necessário se o coletor for executado no mesmo host que o SQL Server)

• Se deseja métricas Básicas ou Avançadas

  Execute isto em uma sessão do PowerShell de administrador:

  [Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql-winauth

  Copiar

  A CLI exibe prompts interativamente para as seguintes variáveis. Você também pode defini-las antecipadamente como variáveis de ambiente para executar de forma não interativa.

  Variável	Descrição	Padrão
  NR_CLI_MSSQL_CONFIG_PRESET	Configuração do NRDOT: 1 para Basic 2 para Advanced	1
  NR_CLI_MSSQL_AUTH_MODE	Autenticação do SQL Server: 1 para autenticação do Windows 2 para gMSA	1
  NR_CLI_MSSQL_WINAUTH_LOCATION	Apenas autenticação do Windows: 1 se o coletor for executado no mesmo host que o SQL Server (a identidade do usuário instalador é usada e o serviço permanece LocalSystem, portanto, nenhuma conta de domínio é necessária) 2 se for executado em um host diferente	1
  NR_CLI_MSSQL_INSTANCES_FILE	Obrigatório. Caminho para o arquivo YAML de instância ( host / port por instância).	Nenhum
  NR_CLI_MSSQL_WIN_ACCOUNT	Conta do Windows à qual conceder permissões, DOMAIN\username . Obrigatório apenas quando NR_CLI_MSSQL_AUTH_MODE for 1 e NR_CLI_MSSQL_WINAUTH_LOCATION for 2 ; deixe em branco para gMSA ou para o fluxo no mesmo host.	Nenhum
  NR_CLI_MSSQL_WIN_PASSWORD	Senha para essa conta do Windows. Obrigatório apenas quando NR_CLI_MSSQL_AUTH_MODE for 1 e NR_CLI_MSSQL_WINAUTH_LOCATION for 2 ; deixe em branco para gMSA ou para o fluxo no mesmo host.	Nenhum
  NR_CLI_MSSQL_GMSA_ACCOUNT	Conta gMSA, DOMAIN\gMSAName$ . Apenas gMSA; deixe em branco para Autenticação do Windows.	Nenhum

  Dica

  Para monitorar mais de uma instância do SQL Server a partir deste coletor, adicione mais entradas ao arquivo de instâncias. Um modo de autenticação e uma identidade do Windows são usados para cada instância no arquivo; identidades diferentes por instância não são suportadas. Um host ou uma porta inválida, um host:port duplicado ou uma instância que falha em sua verificação de versão ou configuração de permissão é ignorado com um motivo registrado em log em vez de abortar toda a instalação. O fluxo de mesmo host (NR_CLI_MSSQL_WINAUTH_LOCATION 1) funciona apenas para instâncias nesta máquina. Liste as instâncias em outros hosts usando o fluxo de host diferente ou gMSA.

Esta receita monitora um ou mais endpoint 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.

1. Crie o arquivo de instâncias, usando o endpoint do RDS como host, com apenas uma entrada se você estiver realizando o monitoramento de apenas uma única instância do RDS:

   bash

   Copiar

   $
   cat > ~/mssql-instances.yml << 'EOF'
   $
   instances:
   $
     - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
   $
       port: 1433
   $
       login_name: newrelic
   $
   EOF

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

   bash

   Copiar

   $
   umask 077
   $
   cat > ~/mssql-secrets.env << 'EOF'
   $
   NR_CLI_MSSQL_ADMIN_USER_1=admin
   $
   NR_CLI_MSSQL_ADMIN_PASSWORD_1=YourMasterPassword1
   $
   EOF
   $
   chmod 600 ~/mssql-secrets.env

   Linux:

   bash

   Copiar

   $
   curl -Ls https://download.newrelic.com/install/newrelic-cli/scripts/install.sh | bash && sudo NEW_RELIC_API_KEY=INSERT_YOUR_API_KEY NEW_RELIC_ACCOUNT_ID=INSERT_YOUR_ACCOUNT_ID NEW_RELIC_REGION=INSERT_YOUR_REGION /usr/local/bin/newrelic install -n nrdot-collector-mssql-rds

   Windows (executar em uma sessão do PowerShell de administrador):

   [Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql-rds

   Copiar

   A CLI exibe prompts interativamente para as seguintes variáveis. Você também pode defini-las antecipadamente como variáveis de ambiente para executar de forma não interativa.

   Variável	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, usando endpoints do RDS como host .	Nenhum
   NR_CLI_MSSQL_SECRETS_FILE	Obrigatório. Caminho para o arquivo de segredos ( KEY=VALUE , um par de nome de usuário/senha mestre do RDS por instância).	Nenhum

   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 método é 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. O coletor é um serviço do Windows com uma conta de logon e se conecta a cada endpoint com essa conta; portanto, uma instalação de múltiplas instâncias sempre usa um modo de autenticação e uma identidade do Windows, concedida em cada endpoint que você listar. Ao contrário do método auto-hospedado acima, não há opção de "mesmo host" aqui: uma conta de domínio (ou gMSA) é sempre necessária.

1. Crie o arquivo de instância, usando cada endpoint do RDS como host, com apenas uma entrada se estiver realizando o monitoramento 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

   Copiar

   Salvar em qualquer lugar no host do coletor, por exemplo, C:\mssql-instances.yml.

   Antes de executar este comando, tenha em mãos:

• O arquivo de instâncias da etapa 1

• Seja usando uma conta de domínio do Windows ou uma conta gMSA

• A conta de domínio (ou conta gMSA) à qual conceder permissões

• Se deseja métricas Básicas ou Avançadas

  Execute isto em uma sessão do PowerShell de administrador:

  [Net.ServicePointManager]::SecurityProtocol = 'tls12, tls'; $WebClient = New-Object System.Net.WebClient; $WebClient.DownloadFile("https://download.newrelic.com/install/newrelic-cli/scripts/install.ps1", "$env:TEMP\install.ps1"); & PowerShell.exe -ExecutionPolicy Bypass -File $env:TEMP\install.ps1; $env:NEW_RELIC_API_KEY='INSERT_YOUR_API_KEY'; $env:NEW_RELIC_ACCOUNT_ID='INSERT_YOUR_ACCOUNT_ID'; $env:NEW_RELIC_REGION='INSERT_YOUR_REGION'; & 'C:\Program Files\New Relic\New Relic CLI\newrelic.exe' install -n nrdot-collector-mssql-rds-winauth

  Copiar

  A CLI exibe prompts interativamente para as seguintes variáveis. Você também pode defini-las antecipadamente como variáveis de ambiente para executar de forma não interativa.

  Variável	Descrição	Padrão
  NR_CLI_MSSQL_CONFIG_PRESET	Configuração do NRDOT: 1 para Basic 2 para Advanced	1
  NR_CLI_MSSQL_AUTH_MODE	Autenticação do SQL Server: 1 para autenticação de domínio do Windows 2 para gMSA	1
  NR_CLI_MSSQL_INSTANCES_FILE	Obrigatório. Caminho para o arquivo YAML de instâncias, usando endpoints do RDS como host .	Nenhum
  NR_CLI_MSSQL_WIN_ACCOUNT	Conta de domínio do Windows à qual conceder permissões, DOMAIN\username . Apenas autenticação de domínio do Windows; deixe em branco para gMSA.	Nenhum
  NR_CLI_MSSQL_WIN_PASSWORD	Senha para essa conta de domínio. Apenas Autenticação de domínio do Windows; deixe em branco para gMSA.	Nenhum
  NR_CLI_MSSQL_GMSA_ACCOUNT	Conta gMSA, DOMAIN\gMSAName$ . Apenas gMSA; deixe em branco para Autenticação de domínio do Windows.	Nenhum

  Dica

  Para monitorar mais de um endpoint do RDS SQL Server a partir deste coletor, adicionar mais entradas ao arquivo de instância. Um modo de autenticação e uma identidade do Windows são usados para cada endpoint no arquivo. Um host ou porta inválida, um host:port duplicado ou um endpoint que falha em sua verificação de versão ou configuração de permissão é ignorado com um motivo registrado em log, em vez de abortar toda a instalação.