Instalar y configurar NRDOT para el monitoreo de MSSQL con Chef

Puede instalar y configurar el Collector de NRDOT para el monitoreo de SQL Server mediante el libro de recetas de Chef newrelic-install. El libro de recetas instala el recolector, crea o autoriza la identidad de monitoreo y configura el recolector cuando ejecuta la receta newrelic-install::default.

Instalación guiada

Para instalar esto a través de la UI de New Relic en su lugar, vaya a one.newrelic.com > Integrations & Agents > Microsoft SQL Server (Database 360) . Siga las instrucciones en pantalla para configurar la integración. Esta página solo cubre la instalación manual.

Requisitos previos

Una cuenta de New Relic con una clave de licencia válida.
Un ID de cuenta de New Relic.
Microsoft SQL Server 2017 o posterior.
Chef 15 o posterior.
SQL Server autohospedado:
- Autenticación de SQL Server: un host recolector de Windows, Ubuntu o RHEL/CentOS, y un inicio de sesión en el rol de servidor sysadmin (o equivalente) con la contraseña.
- Autenticación de Windows o gMSA: un host recolector de Windows y la cuenta de dominio de Windows (o gMSA) a los que otorgar permisos.
SQL Server en AWS RDS:
- Un host recolector de Windows, Ubuntu o RHEL/CentOS con conectividad de red al extremo de RDS (acceso entrante otorgado en el puerto de SQL Server dentro del grupo de seguridad de RDS), junto con el nombre de usuario y la contraseña maestros de RDS.
- Autenticación de dominio de Windows o gMSA: un host recolector de Windows y una instancia de RDS ya unidos a un dominio de Microsoft Active Directory administrado por AWS.
Conectividad de red al extremo OTLP de New Relic correspondiente a la región objetivo.

Descargar el cookbook de Chef

Descargue el cookbook de Chef newrelic-install desde Chef Supermarket al directorio del repositorio de Chef:

bash

$knife supermarket install newrelic-install

Reemplace los atributos predeterminados

Reemplace los atributos predeterminados en attributes/default.rb con los detalles de la cuenta:

Este libro de recetas monitorea una o más instancias de SQL Server desde un solo recolector. En lugar de un solo conjunto de host/puerto/credenciales, lee dos archivos que ya deben existir en el nodo: un archivo de instancias (YAML) que enumera cada instancia a monitorear y un archivo de secretos (KEY=VALUE) con un inicio de sesión de administrador y una contraseña para cada una, indexados para que coincidan.

Cree el archivo de instancias en el nodo. Agregue una entrada por cada instancia de SQL Server que desee que este recolector monitoree, o solo una entrada si solo ejecuta una única instancia:
```
instances:
  - host: localhost
    port: 1433
    login_name: newrelic
```

Cree el archivo de secretos en el nodo con un inicio de sesión y contraseña de administrador para cada instancia, indexado para que coincida con el orden del archivo de instancia. El inicio de sesión de administrador debe ser miembro del rol sysadmin (o equivalente):

bash

$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

Atributo (bajo

env

)

Descripción

Por defecto

NR_CLI_MSSQL_CONFIG_PRESET

Configuración de NRDOT:

1 para Basic
2 para Advanced

1

NR_CLI_MSSQL_INSTANCES_FILE

Obligatorio. Ruta al archivo YAML de instancia, ya presente en el nodo.

Ninguno

NR_CLI_MSSQL_SECRETS_FILE

Obligatorio. Ruta al archivo de secretos (

KEY=VALUE

, un par de inicio de sesión/contraseña de administrador por instancia), ya presente en el nodo.

Ninguno

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

Sugerencia

Para monitorear más de una instancia de SQL Server desde este recolector, agregue más entradas al archivo de instancias y credenciales numeradas coincidentes (_2, _3,... ) al archivo de secretos. Una instancia que no pasa las comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación.

Este objetivo solo es compatible con un host del recolector de Windows. Utiliza la autenticación de Windows (integrated security=true) en lugar de los inicios de sesión de SQL y monitorea una o más instancias de SQL Server desde un único recolector mediante un archivo de instancias (YAML, host/port por instancia, sin archivo de secretos: una identidad de Windows monitorea cada instancia).

Este archivo ya debe existir en el nodo, con solo una entrada si solo ejecuta una sola instancia. Solo se necesitan host y port (no login_name):

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

Para una instancia con nombre, utilice host más su puerto TCP estático en lugar 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

Atributo (bajo `env` )	Descripción	Por defecto
`NR_CLI_MSSQL_CONFIG_PRESET`	Configuración de NRDOT: `1` para Basic `2` para Advanced	`1`
`NR_CLI_MSSQL_AUTH_MODE`	Autenticación de SQL Server: `1` para la autenticación de dominio de Windows `2` para gMSA	`1`
`NR_CLI_MSSQL_WINAUTH_LOCATION`	Solo autenticación de dominio de Windows: `1` si el recolector se ejecuta en el mismo host que SQL Server (se utiliza la identidad del usuario que realiza la instalación y el servicio permanece `LocalSystem`, por lo que no se necesita una cuenta de dominio) `2` si se ejecuta en un host diferente	`1`
`NR_CLI_MSSQL_INSTANCES_FILE`	Obligatorio. Ruta al archivo YAML de instancia ( `host` / `port` por instancia), ya presente en el nodo.	Ninguno
`NR_CLI_MSSQL_WIN_ACCOUNT` / `NR_CLI_MSSQL_WIN_PASSWORD`	Requerido solo cuando `NR_CLI_MSSQL_AUTH_MODE` es `1` y `NR_CLI_MSSQL_WINAUTH_LOCATION` es `2` . Cuenta de dominio de Windows ( `DOMAIN\username` ) y contraseña a la que se otorgarán permisos y con la que se ejecutará el servicio del recolector. No es necesario para el flujo del mismo host ni para gMSA.	Ninguno
`NR_CLI_MSSQL_GMSA_ACCOUNT`	Requerido si `NR_CLI_MSSQL_AUTH_MODE` es `2` . Cuenta gMSA ( `DOMAIN\gMSAName$` ) a la cual otorgar permisos.	Ninguno

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

Sugerencia

Para monitorear más de una instancia de SQL Server desde este recolector, agregue más entradas al archivo de instancias. Se utilizan un modo de autenticación y una identidad de Windows para cada instancia en el archivo. Una instancia que no supera las comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación. El flujo del mismo host (NR_CLI_MSSQL_WINAUTH_LOCATION 1) solo funciona para cualquier instancia en el propio nodo. Utilice el flujo de host diferente o gMSA para cualquier instancia remota o en clúster.

Este libro de recetas monitorea uno o más extremos de RDS SQL Server desde un solo recolector, utilizando el mismo patrón de archivo de instancias/archivo de secretos que el autohospedado (ambos archivos ya deben existir en el nodo).

Cree el archivo de instancia en el nodo, usando el extremo de RDS como host, con solo una entrada si solo realiza el monitoreo de una única instancia de RDS:
```
instances:
  - host: mydb1.abcdefg12345.us-east-1.rds.amazonaws.com
    port: 1433
    login_name: newrelic
```

Cree el archivo de secretos en el nodo con el nombre de usuario maestro y la contraseña de RDS para cada instancia, indexado para coincidir con el orden del archivo de instancia:

bash

$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

Atributo (bajo

env

)

Descripción

Por defecto

NR_CLI_MSSQL_CONFIG_PRESET

Configuración de NRDOT:

1 para Basic
2 para Advanced

1

NR_CLI_MSSQL_INSTANCES_FILE

Obligatorio. Ruta al archivo YAML de instancia, usando extremos de RDS como

host

, ya presente en el nodo.

Ninguno

NR_CLI_MSSQL_SECRETS_FILE

Obligatorio. Ruta al archivo de secretos (

KEY=VALUE

, un par de nombre de usuario/contraseña maestro de RDS por instancia), ya presente en el nodo.

Ninguno

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

Sugerencia

Para monitorear más de un extremo de RDS SQL Server desde este recolector, agregue más entradas al archivo de instancia y credenciales numeradas correspondientes al archivo de secretos. Una instancia que no pasa las comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación.

Este objetivo solo es compatible con un host del recolector de Windows y requiere que las instancias de RDS ya estén unidas a un dominio de AWS Managed Microsoft AD. Monitorea uno o más extremos de RDS SQL Server desde un único recolector mediante un archivo de instancias (YAML, host/port por instancia, utilizando los extremos de RDS como host). A diferencia del objetivo autohospedado anterior, aquí no hay una opción de "mismo host": siempre se requiere una cuenta de dominio (o gMSA).

Este archivo ya debe existir en el nodo, usando cada extremo de RDS como host, con solo una entrada si solo realiza el monitoreo de una única instancia de 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

Atributo (bajo `env` )	Descripción	Por defecto
`NR_CLI_MSSQL_CONFIG_PRESET`	Configuración de NRDOT: `1` para Basic `2` para Advanced	`1`
`NR_CLI_MSSQL_AUTH_MODE`	Autenticación de SQL Server: `1` para la autenticación de dominio de Windows `2` para gMSA	`1`
`NR_CLI_MSSQL_INSTANCES_FILE`	Obligatorio. Ruta al archivo YAML de instancia, usando extremos de RDS como `host` , ya presente en el nodo.	Ninguno
`NR_CLI_MSSQL_WIN_ACCOUNT` / `NR_CLI_MSSQL_WIN_PASSWORD`	Requerido si `NR_CLI_MSSQL_AUTH_MODE` es `1` . Cuenta de dominio de Windows ( `DOMAIN\username` ) y contraseña a la cual otorgar permisos y bajo la cual ejecutar el servicio del recolector.	Ninguno
`NR_CLI_MSSQL_GMSA_ACCOUNT`	Requerido si `NR_CLI_MSSQL_AUTH_MODE` es `2` . Cuenta gMSA ( `DOMAIN\gMSAName$` ) a la cual otorgar permisos.	Ninguno

Sugerencia

No se incluyen valores de atributo predeterminados para estas variables. Establezca explícitamente los que sean relevantes para su objetivo mediante default['newrelic_install']['env'][...].

Sugerencia

Para monitorear más de un extremo de RDS SQL Server desde este recolector, agregue más entradas al archivo de instancias. Se utilizan un modo de autenticación y una identidad de Windows para cada extremo en el archivo. Un extremo que no pasa las comprobaciones se omite con un motivo registrado en lugar de cancelar toda la instalación.

Cargue el cookbook de Chef

Cargue el cookbook de Chef newrelic-install en su servidor de Chef:

bash

$knife cookbook upload newrelic-install

Actualice la lista de ejecución

Agregue la receta newrelic-install a la lista de ejecución de un nodo:

"run_list": [
  "recipe[newrelic-install]"
]

Encuentra y utiliza tus datos

Una vez que sus datos se estén recopilando, puede acceder al monitoreo integral de bases de datos SQL Server a través de la UI de New Relic.

Para encontrar su entidad de base de datos SQL Server en New Relic:

Vaya a one.newrelic.com > All capabilities > Databases.
En el menú desplegable Entity type, seleccione MSSQL instance y luego haga clic en Apply.
Seleccione su base de datos SQL Server de la lista de entidades.
Después de configurar el monitoreo de SQL Server con NRDOT, puede:
- Crea dashboards personalizados para visualizar las métricas de tu base de datos
- Configura alertas para umbrales críticos de rendimiento de la base de datos
- Explore los datos con las capacidades de consulta de New Relic

Configurar la correlación de APM y base de datos

Aprenda a correlacionar el rendimiento de la aplicación con las operaciones de la base de datos en New Relic.

Resolución de problemas

Aprenda a solucionar problemas de la configuración de monitoreo de MSSQL en New Relic.

Referencia de métricas

Obtenga información sobre las métricas disponibles recopiladas por NRDOT Collector.

Te ofrecemos esta traducción automática para facilitar la lectura.

Instalar y configurar NRDOT para el monitoreo de MSSQL con Chef

Instalación guiada

Requisitos previos

Descargar el cookbook de Chef

Reemplace los atributos predeterminados

Autohospedado - autenticación de SQL Server

Sugerencia

Sugerencia

Autohospedado - Autenticación de Windows o gMSA

Sugerencia

Sugerencia

AWS RDS - Autenticación de SQL Server

Sugerencia

Sugerencia

AWS RDS - Autenticación de dominio de Windows o gMSA

Sugerencia

Sugerencia

Cargue el cookbook de Chef

Actualice la lista de ejecución

Encuentra y utiliza tus datos

Configurar la correlación de APM y base de datos

Resolución de problemas

Referencia de métricas

Te ofrecemos esta traducción automática para facilitar la lectura.

Instalar y configurar NRDOT para el monitoreo de MSSQL con Chef

Instalación guiada

Requisitos previos .css-21sua1{background:none;border:none;width:0;padding:0;}

Descargar el cookbook de Chef

Reemplace los atributos predeterminados

Autohospedado - Autenticación de Windows o gMSA

AWS RDS - Autenticación de SQL Server

AWS RDS - Autenticación de dominio de Windows o gMSA

Cargue el cookbook de Chef

Actualice la lista de ejecución

Encuentra y utiliza tus datos

Documentación relacionada

Configurar la correlación de APM y base de datos

Resolución de problemas

Referencia de métricas

Requisitos previos