Monitoreo de Microsoft SQL Server con NRDOT

Avance

Todavía estamos trabajando en esta característica, ¡pero nos encantaría que la probaras!

Esta función se proporciona actualmente como parte de una vista previa de conformidad con nuestras políticas de prelanzamiento.

New Relic ahora permite a su equipo monitorear el rendimiento de su base de datos Microsoft SQL Server utilizando New Relic Distribution of OpenTelemetry (NRDOT) con las capacidades de monitoreo de bases de datos de New Relic. Esta integración proporciona información detallada sobre las métricas de la base de datos, el rendimiento de las consultas y el estado del sistema mediante el recopilador NRDOT.

Este enfoque basado en NRDOT complementa nuestra actual On-Host Integration (OHI) al aprovechar los estándares de OpenTelemetry para el monitoreo de bases de datos, lo que facilita la integración con su stack de observabilidad existente.

Requisitos previos

Antes de comenzar, cerciorar de tener lo siguiente:

Clave de licenciade New Relic válida
Versiones de base de datos compatibles: SQL Server 2017 o posterior
Configuración de la base de datos SQL Server:
- Acceso administrativo a su instancia de SQL Server (rol sysadmin o equivalente)
- Microsoft SQL Server que admite instancias administradas en las instalaciones
- Conectividad de red entre el colector NRDOT y su SQL Server
- SQL Server Management Studio (SSMS) o la utilidad sqlcmd
- Nombre de host o dirección IP del servidor
- Número de puerto (generalmente 1433) o puerto personalizado
- Autenticación de dominio de Windows o de SQL Server
- Preferencia de SSL
Requisitos del sistema:
- Sistema Windows o Linux para ejecutar el colector NRDOT
- Conectividad de red al endpoint OTLP de New Relic

Configurar el NRDOT Collector para el monitoreo de Microsoft SQL Server

Puede utilizar el colector NRDOT para monitorear sus bases de datos de Microsoft SQL Server. El colector NRDOT es una distribución preconfigurada que incluye componentes específicos de New Relic.

Para instalar y configurar el NRDOT Collector, siga estos pasos:

Configurar el colector NRDOT

Instale el colector según su sistema operativo y arquitectura.

Importante

Se recomienda instalar el NRDOT Collector en el mismo host que su instancia de SQL Server para ver métricas a nivel de infraestructura para el monitoreo del rendimiento de consultas.

Descargue y ejecute el instalador pegando esta URL en su navegador para descargar el instalador de la integración NRDOT Collector de New Relic.
```
https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-windows-amd64-latest.msi
```
Ubique el archivo descargado y haga doble clic en él para instalar el NRDOT Collector.

Para la arquitectura AMD64:
- Para distribuciones basadas en Debian/Ubuntu:
  bash
```
$curl -L -o nrdot-collector-host-linux-amd64.deb https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-amd64-latest.deb
$sudo dpkg -i nrdot-collector-host-linux-amd64.deb
```
- Para distribuciones basadas en RHEL/CentOS:
  bash
```
$curl -L -o nrdot-collector-host-linux-amd64.rpm https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-amd64-latest.rpm 
$sudo rpm -ivh nrdot-collector-host-linux-amd64.rpm
```

Para la arquitectura ARM64:

Para distribuciones basadas en Debian/Ubuntu:

bash

$curl -L -o nrdot-collector-host-linux-arm64.deb https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-arm64-latest.deb
$sudo dpkg -i nrdot-collector-host-linux-arm64.deb

Para distribuciones basadas en RHEL/CentOS:

bash

$curl -L -o nrdot-collector-host-linux-arm64.rpm https://download.newrelic.com/database-monitoring/nrdot-collector/nrdot-collector-host-linux-arm64-latest.rpm
$sudo rpm -ivh nrdot-collector-host-linux-arm64.rpm

Configurar el usuario de la base de datos

Ejecute el siguiente script como root user/sysadmin para crear el usuario de monitoreo de newrelic y otorgar permisos globales de lectura.

Para crear un usuario de monitoreo de newrelic, ejecute el siguiente script usando SQL Server Management Studio (SSMS):

USE [master];
GO
CREATE LOGIN [newrelic] WITH PASSWORD = '<PASSWORD>';
GO
-- Instance-level permissions
GRANT VIEW SERVER STATE TO [newrelic];
GRANT VIEW ANY DEFINITION TO [newrelic];
GRANT VIEW ANY DATABASE TO [newrelic];
GO
-- Grant read access privileges to all user databases
DECLARE @name SYSNAME;
DECLARE db_cursor CURSOR READ_ONLY FORWARD_ONLY FOR
SELECT [name]
FROM [master].[sys].[databases]
WHERE [name] NOT IN ('master', 'msdb', 'tempdb', 'model', 'rdsadmin', 'distribution')
AND [state] = 0; -- Only online databases
OPEN db_cursor;
FETCH NEXT FROM db_cursor INTO @name;
WHILE @@FETCH_STATUS = 0
BEGIN
  BEGIN TRY
    PRINT 'Processing database: ' + @name;
    EXEC('USE [' + @name + '];
    IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = ''newrelic'')
    BEGIN
      CREATE USER [newrelic] FOR LOGIN [newrelic];
    END;
    GRANT VIEW DATABASE STATE TO [newrelic];
    GRANT VIEW DEFINITION TO [newrelic];
    ALTER ROLE db_datareader ADD MEMBER [newrelic];');
    PRINT 'Success: ' + @name;
  END TRY
  BEGIN CATCH
    PRINT 'Error on ' + @name + ': ' + ERROR_MESSAGE();
  END CATCH
  FETCH NEXT FROM db_cursor INTO @name;
END
CLOSE db_cursor;
DEALLOCATE db_cursor;
GO

Para crear un usuario de monitoreo de newrelic en Linux, cree un archivo llamado nr-grant-permission.sql en su instancia de Linux con el siguiente contenido:

USE [master];
GO
CREATE LOGIN [newrelic] WITH PASSWORD = '<PASSWORD>';
GO
-- Instance-level permissions
GRANT VIEW SERVER STATE TO [newrelic];
GRANT VIEW ANY DEFINITION TO [newrelic];
GRANT VIEW ANY DATABASE TO [newrelic];
GO
-- Grant read access privileges to all user databases
DECLARE @name SYSNAME;
DECLARE db_cursor CURSOR READ_ONLY FORWARD_ONLY FOR
SELECT [name]
FROM [master].[sys].[databases]
WHERE [name] NOT IN ('master', 'msdb', 'tempdb', 'model', 'rdsadmin', 'distribution')
AND [state] = 0; -- Only online databases
OPEN db_cursor;
FETCH NEXT FROM db_cursor INTO @name;
WHILE @@FETCH_STATUS = 0
BEGIN
  BEGIN TRY
    PRINT 'Processing database: ' + @name;
    EXEC('USE [' + @name + '];
    IF NOT EXISTS (SELECT 1 FROM sys.database_principals WHERE name = ''newrelic'')
    BEGIN
      CREATE USER [newrelic] FOR LOGIN [newrelic];
    END;
    GRANT VIEW DATABASE STATE TO [newrelic];
    GRANT VIEW DEFINITION TO [newrelic];
    ALTER ROLE db_datareader ADD MEMBER [newrelic];');
    PRINT 'Success: ' + @name;
  END TRY
  BEGIN CATCH
    PRINT 'Error on ' + @name + ': ' + ERROR_MESSAGE();
  END CATCH
  FETCH NEXT FROM db_cursor INTO @name;
END
CLOSE db_cursor;
DEALLOCATE db_cursor;
GO

Para ejecutar el script, ejecute el siguiente comando. Reemplace <Your_SA_Password> con su contraseña de administrador de SQL Server:
bash
```
$sqlcmd -S localhost -U sa -P '<Your_SA_Password>' -C -i nr-grant-permission.sql
```

(Opcional) Para verificar que el usuario se creó correctamente y tiene los permisos correctos, ejecute el siguiente comando. Reemplace <Your_SA_Password> con su contraseña de administrador de SQL Server:

bash

$sqlcmd -S localhost -U sa -P '<Your_SA_Password>' -C -Q "SELECT sp.name AS [User], p.permission_name AS [Permission_Granted] FROM sys.server_permissions p JOIN sys.server_principals sp ON p.grantee_principal_id = sp.principal_id WHERE sp.name = 'newrelic';"

Salida esperada:

User Permission_Granted
---------------------------------------------------------------------------------------------
<your_username> CONNECT SQL
<your_username> VIEW ANY DEFINITION
<your_username> VIEW ANY DATABASE
<your_username> VIEW SERVER STATE

Esta salida confirma que su usuario se ha creado correctamente con los permisos de nivel de servidor requeridos.

Configurar el Colector NRDOT

Reemplace su config.yaml con el siguiente contenido:

Ventanas: C:\Program Files (x86)\NRDOT Collector Host\config.yaml

Linux: /etc/nrdot-collector-host/config.yaml

Importante

Si es un usuario actual de NRDOT Collector, asegúrese de fusionar la configuración anterior con su archivo config.yaml existente. Esto incluye agregar los nuevos receptores, procesadores y exportadores para el monitoreo de bases de datos MSSQL, mientras conserva sus configuraciones actuales.

# NRDOT Collector Configuration for New Relic SQL Server Integration
# SQL Server On-Premises/VM Configuration

extensions:
  health_check:

receivers:
  otlp:
    protocols:
      grpc:
      http:

  hostmetrics:
    # Default collection interval is 60s. Lower if you need finer granularity.
    collection_interval: 60s
    scrapers:
      cpu:
        metrics:
          system.cpu.time:
            enabled: false
          system.cpu.utilization:
            enabled: true
      load:
      memory:
        metrics:
          system.memory.utilization:
            enabled: true
      paging:
        metrics:
          system.paging.utilization:
            enabled: false
          system.paging.faults:
            enabled: false
      filesystem:
        metrics:
          system.filesystem.utilization:
            enabled: true
      disk:
        metrics:
          system.disk.merged:
            enabled: false
          system.disk.pending_operations:
            enabled: false
          system.disk.weighted_io_time:
            enabled: false
      network:
        metrics:
          system.network.connections:
            enabled: false
     # Uncomment to enable process metrics, which can be noisy but valuable.
     # processes:
     # process:
     #  metrics:
     #    process.cpu.utilization:
     #      enabled: true
     #    process.cpu.time:
     #      enabled: false

  filelog:
    include:
      - /var/log/alternatives.log
      - /var/log/cloud-init.log
      - /var/log/auth.log
      - /var/log/dpkg.log
      - /var/log/syslog
      - /var/log/messages
      - /var/log/secure
      - /var/log/yum.log

  newrelicsqlserver:
    hostname: "<YOUR_DB_HOST>"
    port: "<YOUR_DB_PORT>"
    username: "<USERNAME>"
    password: "<PASSWORD>"
    monitored_databases: []
    # timeout: 30s
    # collection_interval: 15s  
    # query_monitoring_fetch_interval: 15
    # query_monitoring_response_time_threshold: 100
    # query_monitoring_count_threshold: 30
    # interval_calculator_cache_ttl_minutes: 10

    # Metric Category Toggles - Enable/disable entire categories of metrics
    # enable_instance_metrics: true
    # enable_database_metrics: true
    # enable_user_connection_metrics: true
    # enable_wait_time_metrics: true
    # enable_failover_cluster_metrics: true
    # enable_database_principals_metrics: true
    # enable_database_role_membership_metrics: true
    # enable_security_metrics: true
    # enable_lock_metrics: true
    # enable_thread_pool_metrics: true
    # enable_tempdb_metrics: true

processors:
  # group system.cpu metrics by cpu
  metricstransform:
    transforms:
      - include: system.cpu.utilization
        action: update
        operations:
          - action: aggregate_labels
            label_set: [ state ]
            aggregation_type: mean
      - include: system.paging.operations
        action: update
        operations:
          - action: aggregate_labels
            label_set: [ direction ]
            aggregation_type: sum

  # remove system.cpu metrics for states
  filter/exclude_cpu_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "interrupt"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "nice"'
        - 'metric.name == "system.cpu.utilization" and attributes["state"] == "softirq"'

  filter/exclude_memory_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "inactive"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "cached"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "buffered"'
        - 'metric.name == "system.memory.utilization" and attributes["state"] == "slab_reclaimable"'

  filter/exclude_memory_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.memory.usage" and attributes["state"] == "slab_unreclaimable"'
        - 'metric.name == "system.memory.usage" and attributes["state"] == "inactive"'

  filter/exclude_filesystem_utilization:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.utilization" and attributes["type"] == "squashfs"'

  filter/exclude_filesystem_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.usage" and attributes["state"] == "reserved"'

  filter/exclude_filesystem_inodes_usage:
    metrics:
      datapoint:
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["type"] == "squashfs"'
        - 'metric.name == "system.filesystem.inodes.usage" and attributes["state"] == "reserved"'

  filter/exclude_system_disk:
    metrics:
      datapoint:
        - 'metric.name == "system.disk.operations" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.merged" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.io_time" and IsMatch(attributes["device"], "^loop.*") == true'
        - 'metric.name == "system.disk.operation_time" and IsMatch(attributes["device"], "^loop.*") == true'

  filter/exclude_system_paging:
    metrics:
      datapoint:
        - 'metric.name == "system.paging.usage" and attributes["state"] == "cached"'
        - 'metric.name == "system.paging.operations" and attributes["type"] == "cached"'

  filter/exclude_network:
    metrics:
      datapoint:
        - 'IsMatch(metric.name, "^system.network.*") == true and attributes["device"] == "lo"'

  attributes/exclude_system_paging:
    include:
      match_type: strict
      metric_names:
        - system.paging.operations
    actions:
      - key: type
        action: delete

  # Transform to clear description and unit fields
  transform/clear_metadata:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")

  # Filter to only include execution plan and event metrics (for logs conversion)
  filter/exec_plan_include:
    metrics:
      include:
        match_type: strict
        metric_names:
          - sqlserver.slowquery.query_details
          - sqlserver.execution.plan
          - sqlserver.blocking_query.details
          - sqlserver.activequery.query_details

  # Filter to exclude execution plan and event metrics (from main metrics pipeline)
  filter/exec_plan_exclude:
    metrics:
      exclude:
        match_type: strict
        metric_names:
          - sqlserver.slowquery.query_details
          - sqlserver.execution.plan
          - sqlserver.blocking_query.details
          - sqlserver.activequery.query_details

  cumulativetodelta:
    max_staleness: 5m
    include:
      match_type: strict
      metrics:
        # Wait stats (sys.dm_os_wait_stats)
        - sqlserver.wait_stats.latch.wait_time_ms
        - sqlserver.wait_stats.latch.waiting_tasks_count
        - sqlserver.wait_stats.wait_time_ms
        - sqlserver.wait_stats.waiting_tasks_count
        # Instance stats (sys.dm_os_performance_counters)
        - sqlserver.stats.sql_compilations_per_sec
        - sqlserver.stats.sql_recompilations_per_sec
        - sqlserver.stats.lock_waits_per_sec
        - sqlserver.stats.deadlocks_per_sec
        - sqlserver.stats.user_errors_per_sec
        - sqlserver.stats.kill_connection_errors_per_sec
        - sqlserver.access.page_splits_per_sec
        - sqlserver.buffer.checkpoint_pages_per_sec
        - sqlserver.bufferpool.batch_requests_per_sec
        - sqlserver.instance.transactions_per_sec
        - sqlserver.instance.forced_parameterizations_per_sec
        - sqlserver.instance.full_scans_rate
        - sqlserver.instance.lock_timeouts_rate
        # Database log (sys.dm_os_performance_counters)
        - sqlserver.database.log.flushes_per_sec
        - sqlserver.database.log.bytes_flushed_per_sec
        - sqlserver.database.log.flush_waits_per_sec
        # Failover cluster
        - sqlserver.failover_cluster.log_bytes_received_per_sec
        # User connections
        - sqlserver.user_connections.authentication.logins_per_sec

  deltatorate:
    metrics:
      - sqlserver.wait_stats.latch.wait_time_ms
      - sqlserver.wait_stats.latch.waiting_tasks_count
      - sqlserver.wait_stats.wait_time_ms
      - sqlserver.wait_stats.waiting_tasks_count
      - sqlserver.stats.sql_compilations_per_sec
      - sqlserver.stats.sql_recompilations_per_sec
      - sqlserver.stats.lock_waits_per_sec
      - sqlserver.stats.deadlocks_per_sec
      - sqlserver.stats.user_errors_per_sec
      - sqlserver.stats.kill_connection_errors_per_sec
      - sqlserver.access.page_splits_per_sec
      - sqlserver.buffer.checkpoint_pages_per_sec
      - sqlserver.bufferpool.batch_requests_per_sec
      - sqlserver.instance.transactions_per_sec
      - sqlserver.instance.forced_parameterizations_per_sec
      - sqlserver.instance.full_scans_rate
      - sqlserver.instance.lock_timeouts_rate
      - sqlserver.database.log.flushes_per_sec
      - sqlserver.database.log.bytes_flushed_per_sec
      - sqlserver.database.log.flush_waits_per_sec
      - sqlserver.failover_cluster.log_bytes_received_per_sec
      - sqlserver.user_connections.authentication.logins_per_sec

  transform/host:
    metric_statements:
      - context: metric
        statements:
          - set(metric.description, "")
          - set(metric.unit, "")

  transform:
    trace_statements:
      - context: span
        statements:
          - truncate_all(span.attributes, 4095)
          - truncate_all(resource.attributes, 4095)
    log_statements:
      - context: log
        statements:
          - truncate_all(log.attributes, 4095)
          - truncate_all(resource.attributes, 4095)

  # used to prevent out of memory situations on the collector
  memory_limiter:
    check_interval: 1s
    limit_mib: ${env:NEW_RELIC_MEMORY_LIMIT_MIB:-100}

  batch:

  resourcedetection:
    detectors: ["system"]
    system:
      hostname_sources: ["os"]
      resource_attributes:
        host.id:
          enabled: true

  resourcedetection/db_safe:
    detectors: ["system"]
    override: false
    system:
      hostname_sources: ["os"]
      resource_attributes:
        host.id:
          enabled: true

  resourcedetection/cloud:
    detectors: ["gcp", "ec2", "azure"]
    timeout: 2s
    override: true

  resourcedetection/env:
    detectors: ["env"]
    timeout: 2s
    override: true

connectors:
  metricsaslogs:
    include_resource_attributes: true
    include_scope_info: true

exporters:
  otlphttp:
    endpoint: "<YOUR_NEWRELIC_OTLP_ENDPOINT>"
    headers:
      api-key: "<YOUR_NEWRELIC_API_KEY>"
    compression: gzip

service:
  pipelines:
    metrics/host:
      receivers: [hostmetrics]
      processors:
        - memory_limiter
        - metricstransform
        - filter/exclude_cpu_utilization
        - filter/exclude_memory_utilization
        - filter/exclude_memory_usage
        - filter/exclude_filesystem_utilization
        - filter/exclude_filesystem_usage
        - filter/exclude_filesystem_inodes_usage
        - filter/exclude_system_disk
        - filter/exclude_network
        - attributes/exclude_system_paging
        - transform/host
        - resourcedetection
        - resourcedetection/cloud
        - resourcedetection/db_safe
        - resourcedetection/env
        - cumulativetodelta
        - deltatorate
        - batch
      exporters: [otlphttp]
    traces:
      receivers: [otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
      exporters: [otlphttp]
    metrics:
      receivers: [newrelicsqlserver, otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, filter/exec_plan_exclude, batch]
      exporters: [otlphttp]
    logs:
      receivers: [metricsaslogs, otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, batch]
      exporters: [otlphttp]
    metrics/exec_plan_to_logs:
      receivers: [newrelicsqlserver, otlp]
      processors: [memory_limiter, transform, resourcedetection, resourcedetection/cloud, resourcedetection/env, filter/exec_plan_include, batch]
      exporters: [metricsaslogs]
  extensions: [health_check]

Parámetro de configuración

La siguiente tabla describe los parámetros de configuración clave para el receptor newrelicsqlserver:

Parámetro	Descripción
`<YOUR_DB_HOST>`	Ingrese el nombre de host o la dirección IP de SQL Server
`<YOUR_DB_PORT>`	Ingrese el número de puerto de SQL Server. El valor predeterminado está establecido en 1433.
`<USERNAME>`	Ingrese su nombre de usuario de la base de datos para la autenticación
`<PASSWORD>`	Ingrese su contraseña de la base de datos para la autenticación
`<YOUR_NEWRELIC_OTLP_ENDPOINT>`	Ingrese el endpoint OTLP de New Relic. Para obtener más información, consulta la documentación de los endpoints OTLP de New Relic.
`<YOUR_NEWRELIC_API_KEY>`	Ingrese su clave de API de New Relic.
`query_monitoring_response_time_threshold`	Tiempo de respuesta mínimo en milisegundos para considerar una consulta como lenta. El valor predeterminado está establecido en `100` ms.
`query_monitoring_count_threshold`	Recuento mínimo de ejecuciones para incluir una consulta en el monitoreo. El valor predeterminado está establecido en `30` .
`query_monitoring_fetch_interval`	Intervalo en segundos para obtener datos de monitoreo de consultas. El valor predeterminado está establecido en `15` segundos.
`collection_interval`	Intervalo en segundos para recopilar métricas. El valor predeterminado está establecido en `15s` .

Reiniciar el colector NRDOT

Después de actualizar la configuración, reinicie el servicio de colector NRDOT:

Para Windows, para reiniciar el servicio NRDOT Collector, ejecute:
bash
```
$net stop nrdot-collector-host
$net start nrdot-collector-host
```
Para Linux, para reiniciar el servicio NRDOT Collector, ejecute:
bash
```
$sudo systemctl restart nrdot-collector-host
```
Sugerencia
Siempre reinicie el servicio de recopilador NRDOT después de realizar cambios de configuración para garantizar que los nuevos ajustes surtan efecto.

(Opcional) Configurar la correlación de APM y base de datos

Para correlacionar el rendimiento de su aplicación con las operaciones de la base de datos, puede configurar la identificación del servicio de base de datos. Esta función le permite ver exactamente qué aplicaciones están generando workloads de base de datos específicas. Para obtener más información, consulte configurar la identificación de servicios de base de datos para obtener la correlación entre APM y la base de datos en New Relic.

Importante

Para ver los datos de rendimiento de la base de datos en APM, ambas entidades deben estar en la misma cuenta de New Relic. Si las entidades están en diferentes cuentas de New Relic, debe tener acceso a ambas cuentas para ver los datos.

(Opcional) Configurar la gestión de secretos

La función de gestión de secretos le permite administrar de forma segura información confidencial, como las credenciales de bases de datos. Esto ayuda a mejorar la seguridad de su configuración de monitoreo al evitar la codificación rígida de datos sensibles en los archivos de configuración. Para obtener más información, consulta gestión de secretos.

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 https://one.newrelic.com > All Capabilities > Databases.
Establezca los criterios de búsqueda como instrumentation.provider = opentelemetry.
Seleccione su base de datos SQL Server de la lista de entidades.

Comandos admitidos del colector NRDOT

Para administrar el servicio NRDOT Collector, ver los logs o verificar el estado del servicio, utilice los siguientes comandos disponibles según su sistema operativo.

Para reiniciar NRDOT Collector:

bash

$net stop nrdot-collector-host
$net start nrdot-collector-host

Para verificar el estado de NRDOT Collector:
bash
```
$sc query nrdot-collector-host
```
Para ver los logs de NRDOT Collector:
1. Escribe Event Viewer en la barra de búsqueda y selecciónalo.
2. En la barra lateral izquierda, expanda la carpeta llamada Windows Logs.
3. Haga clic en Aplicación para cargar los eventos específicos de la aplicación en el panel central.
4. Busque eventos con tipo de fuente = nrdot-collector-host
Para eliminar el servicio NRDOT Collector, desinstálelo a través de Add/Remove Programs.

Para validar el estado de la instalación:
- Para distribuciones basadas en Debian/Ubuntu:
  bash
```
$dpkg -l | grep nrdot-collector-host
```
- Para distribuciones basadas en RHEL/CentOS:
  bash
```
$rpm -q nrdot-collector-host || ls /etc/nrdot-collector-host
```

Para reiniciar NRDOT Collector:

bash

$sudo systemctl restart nrdot-collector-host

Para verificar el estado de NRDOT Collector:
bash
```
$sudo systemctl status nrdot-collector-host
```

Para ver los logs de NRDOT Collector:

bash

$sudo journalctl -u nrdot-collector-host -f

Para eliminar el servicio NRDOT Collector:
- Para distribuciones basadas en Debian/Ubuntu:
  bash
```
$sudo apt-get purge -y nrdot-collector-host
```
- Para distribuciones basadas en RHEL/CentOS:
  bash
```
$sudo dnf remove -y nrdot-collector-host&& sudo rm -rf /etc/nrdot-collector-host
```

Resolución de problemas

Si encuentra algún problema de conectividad de red con el NRDOT Collector, ejecute los siguientes comandos para probar la conectividad con su instancia de SQL Server en el puerto 1433:

Para Windows, ejecute:

bash

$Test-NetConnection -ComputerName <YOUR_IP_ADDRESS> -Port <YOUR_PORT_NUMBER>

Para Linux, ejecute:

bash

$nc -zv <YOUR_IP_ADDRESS> <YOUR_PORT_NUMBER>

Métricas disponibles

Monitoree el rendimiento de su base de datos SQL Server con métricas organizadas por banderas de configuración. Las métricas predeterminadas se recopilan automáticamente para la funcionalidad de la UI de New Relic. También puede utilizar las métricas adicionales proporcionadas para obtener información más avanzada y profunda cuando habilite scrapers específicos.

Métrica predeterminada

Estas métricas son esenciales para las funciones de monitoreo de SQL Server de New Relic y se recopilan automáticamente independientemente de su configuración.

Nombre de la métrica	Descripción
`sqlserver.stats.connections`	Conexiones de usuario actuales
`sqlserver.instance.blocked_processes_count`	Número de procesos bloqueados
`sqlserver.instance.buffer_pool_hit_percent`	Porcentaje de aciertos del grupo de búferes
`sqlserver.instance.buffer_pool_size`	Tamaño del grupo de búferes
`sqlserver.instance.compilations_per_batch`	Compilaciones de SQL por solicitud de lote
`sqlserver.instance.connections_active`	Número de conexiones activas
`sqlserver.instance.forced_parameterizations_per_sec`	Parametrizaciones forzadas por segundo
`sqlserver.instance.full_scans_rate`	Escaneos de tabla completa/índice por segundo
`sqlserver.instance.lock_timeouts_rate`	Número de tiempos de espera de bloqueo por segundo
`sqlserver.instance.memory_available`	Memoria física disponible en el sistema
`sqlserver.instance.memory_utilization_percent`	Porcentaje de utilización de memoria
`sqlserver.instance.page_splits_per_batch`	Divisiones de página por solicitud por lotes
`sqlserver.instance.target_memory_kb`	Memoria del servidor de destino en KB
`sqlserver.instance.transactions_per_sec`	Transacciones por segundo
`sqlserver.buffer.cache_hit_ratio`	Porcentaje de la tasa de aciertos de la caché de búfer
`sqlserver.buffer.checkpoint_pages_per_sec`	Páginas de punto de control por segundo
`sqlserver.buffer.page_life_expectancy`	Expectativa de vida de la página en segundos
`sqlserver.bufferpool.page_life_expectancy_ms`	Expectativa de vida de la página en milisegundos
`sqlserver.database.io.stall_ms`	Tiempo total de espera de E/S para la base de datos SQL Server
`sqlserver.database.log.flushes_per_sec`	Número de operaciones de vaciado de log por segundo
`sqlserver.database.log.transaction_growth`	Número de eventos de crecimiento del log para la base de datos de SQL Server
`sqlserver.database.page_file_available_bytes`	Espacio de archivo de paginación disponible para la base de datos de SQL Server
`sqlserver.database.page_file_total_bytes`	Espacio total del archivo de paginación para la base de datos de SQL Server
`sqlserver.database.size.data_mb`	Tamaño total del archivo de datos excluyendo archivos de log
`sqlserver.database.size.total_mb`	Tamaño total de la base de datos, incluidos los archivos de datos y de log
`sqlserver.stats.deadlocks_per_sec`	Interbloqueos por segundo
`sqlserver.stats.kill_connection_errors_per_sec`	Errores de terminación de conexión por segundo
`sqlserver.stats.lock_waits_per_sec`	Esperas de bloqueo por segundo
`sqlserver.stats.sql_compilations_per_sec`	Compilaciones de SQL por segundo
`sqlserver.stats.sql_recompilations_per_sec`	Recompilaciones de SQL por segundo
`sqlserver.stats.user_errors_per_sec`	Errores de usuario por segundo
`sqlserver.wait_stats.wait_time_ms`	Tiempo de espera total en milisegundos
`sqlserver.access.page_splits_per_sec`	Divisiones de página por segundo
`sqlserver.execution.plan`	Operador del plan de ejecución de SQL Server con estimaciones de costo detalladas
`sqlserver.plan.avg_elapsed_time_ms`	Tiempo transcurrido promedio por ejecución de este plan (histórico)
`sqlserver.slowquery.avg_elapsed_time_ms`	Tiempo transcurrido promedio por ejecución en milisegundos
`sqlserver.slowquery.historical_avg_elapsed_time_ms`	Promedio histórico del tiempo transcurrido en milisegundos
`sqlserver.slowquery.historical_execution_count`	Recuento histórico de ejecuciones
`sqlserver.slowquery.historical_logical_reads`	Total histórico de lecturas lógicas
`sqlserver.slowquery.historical_physical_reads`	Total histórico de lecturas físicas
`sqlserver.slowquery.historical_rows`	Total histórico de filas devueltas
`sqlserver.slowquery.historical_wait_time_ms`	Tiempo de espera total histórico en milisegundos
`sqlserver.slowquery.historical_worker_time_ms`	Tiempo histórico total del trabajador (CPU) en milisegundos
`sqlserver.slowquery.interval_avg_elapsed_time_ms`	Tiempo transcurrido promedio del intervalo en milisegundos
`sqlserver.slowquery.interval_avg_logical_reads`	Promedio de lecturas lógicas del intervalo por ejecución
`sqlserver.slowquery.interval_avg_physical_reads`	Promedio de lecturas físicas por ejecución del intervalo
`sqlserver.slowquery.interval_avg_rows`	Promedio de filas devueltas por ejecución en el intervalo
`sqlserver.slowquery.interval_avg_wait_time_ms`	Tiempo de espera promedio del intervalo por ejecución en milisegundos
`sqlserver.slowquery.interval_avg_worker_time_ms`	Tiempo promedio de trabajador (CPU) del intervalo por ejecución en milisegundos
`sqlserver.slowquery.interval_elapsed_time_ms`	Tiempo total transcurrido del intervalo en milisegundos
`sqlserver.slowquery.interval_execution_count`	Recuento de ejecuciones de intervalo
`sqlserver.slowquery.interval_logical_reads`	Lecturas lógicas de intervalo
`sqlserver.slowquery.interval_physical_reads`	Lecturas físicas de intervalo
`sqlserver.slowquery.interval_rows`	Filas de intervalo devueltas
`sqlserver.slowquery.interval_wait_time_ms`	Tiempo de espera del intervalo en milisegundos
`sqlserver.slowquery.interval_worker_time_ms`	Tiempo del trabajador (CPU) del intervalo en milisegundos
`sqlserver.slowquery.query_details`	Detalles de la consulta, incluidos el texto y las marcas de tiempo para consultas lentas
`sqlserver.activequery.wait_time_seconds`	Tiempo de espera de la consulta actualmente en ejecución
`sqlserver.blocking_query.details`	Detalles de la consulta de bloqueo para la correlación con consultas activas

Métricas adicionales

Habilite estas métricas adicionales según sea necesario para obtener información más detallada sobre el rendimiento y el estado de su base de datos SQL Server.

Habilite enable_instance_metrics: true para recopilar estas métricas:

Nombre de la métrica	Descripción
`sqlserver.instance.background_processes_count`	Número de procesos en segundo plano
`sqlserver.instance.disk_in_bytes`	Espacio total en disco en bytes
`sqlserver.instance.dormant_processes_count`	Número de procesos inactivos
`sqlserver.instance.memory_total`	Memoria física total del sistema
`sqlserver.instance.preconnect_processes_count`	Número de procesos de preconexión
`sqlserver.instance.runnable_processes_count`	Número de procesos ejecutables
`sqlserver.instance.runnable_tasks`	Número de tareas ejecutables
`sqlserver.instance.running_processes_count`	Número de procesos en ejecución
`sqlserver.instance.sleeping_processes_count`	Número de procesos dormidos
`sqlserver.instance.suspended_processes_count`	Número de procesos suspendidos

Nombre de la métrica	Descripción
`sqlserver.bufferpool.batch_requests_per_sec`	Solicitudes por lotes por segundo

Nombre de la métrica	Descripción
`sqlserver.connections.user`	Número de conexiones de usuario

Habilite enable_database_metrics: true para recopilar estas métricas:

Nombre de la métrica	Descripción
`sqlserver.database.bufferpool.size_per_database_bytes`	Tamaño del grupo de búferes de SQL Server asignado a la base de datos
`sqlserver.database.log.bytes_flushed_per_sec`	Número de bytes de logs vaciados por segundo
`sqlserver.database.log.flush_waits_per_sec`	Número de operaciones de espera de vaciado por segundo
`sqlserver.database.log.used_space_mb`	Espacio de logs usado en megabytes
`sqlserver.database.max_disk_size_bytes`	Tamaño máximo de disco permitido para la base de datos de SQL Server
`sqlserver.database.principals.applicationRoles`	Número de roles de aplicación
`sqlserver.database.principals.old`	Número de entidades principales antiguas (con una antigüedad mayor a 365 días)
`sqlserver.database.principals.orphanedUsers`	Número de usuarios huérfanos sin inicio de sesión de servidor
`sqlserver.database.principals.recentlyCreated`	Número de principales creados recientemente (últimos 30 días)
`sqlserver.database.principals.roles`	Número de roles de base de datos
`sqlserver.database.principals.sqlUsers`	Número de usuarios de autenticación SQL
`sqlserver.database.principals.total`	Número total de entidades de seguridad de la base de datos
`sqlserver.database.principals.users`	Número de usuarios de base de datos
`sqlserver.database.principals.windowsUsers`	Número de usuarios de autenticación de Windows
`sqlserver.database.role.members.applicationRoles`	Número de miembros del rol de aplicación
`sqlserver.database.role.members.crossRole`	Número de miembros de roles cruzados
`sqlserver.database.role.members.highPrivilege`	Número de miembros de roles de alto privilegio
`sqlserver.database.role.members.unique`	Número de miembros únicos en roles
`sqlserver.database.role.memberships.active`	Número de membresías de rol activas
`sqlserver.database.role.memberships.custom`	Número de membresías de roles personalizados
`sqlserver.database.role.memberships.nested`	Número de membresías de roles anidados
`sqlserver.database.role.memberships.total`	Número total de membresías de rol
`sqlserver.database.role.memberships.users`	Número de membresías de roles de usuario
`sqlserver.database.role.permission.memberCount`	Número de miembros en el rol
`sqlserver.database.role.permission.riskLevel`	Nivel de riesgo del rol
`sqlserver.database.role.roles.empty`	Número de roles vacíos
`sqlserver.database.role.roles.withMembers`	Número de roles únicos con miembros
`sqlserver.database.transactions.active`	Número de transacciones activas

Habilite enable_failover_cluster_metrics: true para recopilar estas métricas:

Nombre de la métrica	Descripción
`sqlserver.failover_cluster.ag_cluster_type`	Tipo de clúster para el grupo de disponibilidad
`sqlserver.failover_cluster.ag_failure_condition_level`	Nivel de condición de conmutación por error automática para el grupo de disponibilidad
`sqlserver.failover_cluster.ag_health_check_timeout`	Tiempo de espera de la comprobación de estado para el grupo de disponibilidad en milisegundos
`sqlserver.failover_cluster.ag_replica_role`	Rol actual de la réplica en el Grupo de disponibilidad
`sqlserver.failover_cluster.ag_required_sync_secondaries`	Número de réplicas secundarias síncronas requeridas para confirmar transacciones
`sqlserver.failover_cluster.ag_synchronization_health`	Salud de la sincronización de datos entre la réplica primaria y secundaria
`sqlserver.failover_cluster.flow_control_time_ms`	Tiempo empleado en control de flujo por registros de logs de la réplica principal en milisegundos por segundo
`sqlserver.failover_cluster.log_bytes_received_per_sec`	Tasa de registros de logs recibidos por la réplica secundaria desde la réplica primaria en bytes por segundo
`sqlserver.failover_cluster.log_send_queue_kb`	Cantidad de registros de log en la cola de envío de logs esperando ser enviados a la réplica secundaria en kilobytes
`sqlserver.failover_cluster.redo_queue_kb`	Cantidad de registros de log en la cola de rehacer esperando ser rehechos en la réplica secundaria en kilobytes
`sqlserver.failover_cluster.redo_rate_kb_sec`	Tasa a la que se rehacen los logs de log en la réplica secundaria en kilobytes por segundo
`sqlserver.failover_cluster.transaction_delay_ms`	Retraso promedio de las transacciones en la réplica secundaria en milisegundos

Habilite enable_lock_metrics: true para recopilar estas métricas:

Nombre de la métrica	Descripción
`sqlserver.lock.mode.bulk_update`	Número de bloqueos de actualización masiva
`sqlserver.lock.mode.exclusive`	Número de bloqueos exclusivos
`sqlserver.lock.mode.intent`	Número de bloqueos de intención
`sqlserver.lock.mode.schema`	Número de bloqueos de esquema
`sqlserver.lock.mode.shared`	Número de bloqueos compartidos
`sqlserver.lock.mode.shared_intent_exclusive`	Número de bloqueos de intención compartida exclusiva
`sqlserver.lock.mode.total`	Total de bloqueos activos por modo
`sqlserver.lock.mode.update`	Número de bloqueos de actualización
`sqlserver.lock.resource.allocation_unit`	Número de bloqueos de unidad de asignación
`sqlserver.lock.resource.application`	Número de bloqueos de aplicación
`sqlserver.lock.resource.database_level`	Número de bloqueos a nivel de base de datos
`sqlserver.lock.resource.extent`	Número de bloqueos a nivel de extensión
`sqlserver.lock.resource.file`	Número de bloqueos a nivel de archivo
`sqlserver.lock.resource.hobt`	Número de bloqueos de montón o árbol B
`sqlserver.lock.resource.key`	Número de bloqueos a nivel de clave
`sqlserver.lock.resource.metadata`	Número de bloqueos de metadatos
`sqlserver.lock.resource.page`	Número de bloqueos a nivel de página
`sqlserver.lock.resource.row`	Número de bloqueos a nivel de fila
`sqlserver.lock.resource.table`	Número de bloqueos a nivel de tabla
`sqlserver.lock.resource.total`	Total de bloqueos activos en la base de datos

Nombre de la métrica	Descripción
`sqlserver.locked_object`	Objeto de base de datos bloqueado por una sesión

Habilite enable_instance_metrics: true para recopilar estas métricas:

Nombre de la métrica	Descripción
`sqlserver.memory.target`	Memoria del servidor de destino en KB
`sqlserver.memory.total`	Memoria total del servidor en KB

Habilite enable_security_metrics: true para recopilar estas métricas:

Nombre de la métrica	Descripción
`sqlserver.security.server_principals_count`	Número total de entidades de seguridad del servidor (inicios de sesión)
`sqlserver.security.server_role_members_count`	Número total de miembros del rol del servidor

Habilite enable_tempdb_metrics: true para recopilar estas métricas:

Nombre de la métrica	Descripción
`sqlserver.tempdb.allocation_waits_ms`	Tiempo de espera total relacionado con la asignación
`sqlserver.tempdb.current_waiters`	Número de tareas esperando actualmente en latches de página de TempDB
`sqlserver.tempdb.data_file_count`	Número de archivos de datos de TempDB
`sqlserver.tempdb.pagelatch_waits_ms`	Tiempo total de espera de latch de página desde el inicio del servidor
`sqlserver.tempdb.total_size_mb`	Tamaño total de los archivos de datos de TempDB

Habilite enable_thread_pool_metrics: true para recopilar estas métricas:

Nombre de la métrica	Descripción
`sqlserver.threadpool.current_tasks`	Total de tareas asignadas actualmente a los programadores
`sqlserver.threadpool.max_workers`	Máximo de hilos de trabajo configurados
`sqlserver.threadpool.runnable_tasks`	Tareas listas para ejecutarse pero esperando tiempo de CPU
`sqlserver.threadpool.running_workers`	Número de hilos de trabajo actualmente en ejecución
`sqlserver.threadpool.utilization_percent`	Porcentaje de hilos de trabajo actualmente en uso
`sqlserver.threadpool.waiting_tasks`	Número de tareas actualmente en espera de hilos de trabajo del pool de hilos
`sqlserver.threadpool.work_queue_count`	Número total de tareas en las colas de trabajo del programador

Habilite enable_user_connection_metrics: true para recopilar estas métricas:

Nombre de la métrica	Descripción
`sqlserver.user_connections.authentication.churn_rate`	Tasa de rotación de conexiones (relación cierre de sesión/inicio de sesión como porcentaje)
`sqlserver.user_connections.authentication.logins_per_sec`	Tasa actual de inicio de sesión por segundo
`sqlserver.user_connections.authentication.recent_failed_logins`	Recuento de inicios de sesión fallidos en la última hora
`sqlserver.user_connections.authentication.total_failed_logins`	Recuento total de intentos de inicio de sesión fallidos en el log de errores actual
`sqlserver.user_connections.authentication.unique_failed_sources`	Recuento de IPs de origen distintas con inicios de sesión fallidos
`sqlserver.user_connections.authentication.unique_failed_users`	Recuento de nombres de usuario distintos con inicios de sesión fallidos
`sqlserver.user_connections.client.count`	Número de conexiones agrupadas por host cliente y programa
`sqlserver.user_connections.client.unique_hosts`	Recuento de hosts de cliente únicos con conexiones activas
`sqlserver.user_connections.client.unique_programs`	Recuento de programas únicos con conexiones activas
`sqlserver.user_connections.runnable`	Número de conexiones de usuario ejecutables
`sqlserver.user_connections.running`	Número de conexiones de usuario en ejecución
`sqlserver.user_connections.sleeping`	Número de conexiones de usuario inactivas
`sqlserver.user_connections.suspended`	Número de conexiones de usuario suspendidas
`sqlserver.user_connections.total`	Número total de conexiones de usuario en todos los estados
`sqlserver.user_connections.utilization.active_ratio`	Proporción de conexiones activas con respecto a las conexiones totales
`sqlserver.user_connections.utilization.idle_ratio`	Proporción de conexiones inactivas respecto a las conexiones totales

Habilite enable_wait_time_metrics: true para recopilar estas métricas:

Nombre de la métrica	Descripción
`sqlserver.wait_stats.latch.wait_time_ms`	Tiempo de espera de latch en milisegundos
`sqlserver.wait_stats.latch.waiting_tasks_count`	Número de tareas esperando en latches
`sqlserver.wait_stats.waiting_tasks_count`	Número de tareas actualmente en espera

Que sigue

Después de configurar el monitoreo de bases de datos SQL Server con NRDOT:

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
Explora tus datos con las capacidades de consulta de New Relic

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

Monitoreo de Microsoft SQL Server con NRDOT

Avance

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

Configurar el NRDOT Collector para el monitoreo de Microsoft SQL Server

Configurar el colector NRDOT

Importante

Para Linux

Configurar el usuario de la base de datos

Para Windows (SSMS)

Para Linux (sqlcmd)

Configurar el Colector NRDOT

Importante

Parámetro de configuración

Reiniciar el colector NRDOT

Sugerencia

(Opcional) Configurar la correlación de APM y base de datos

Importante

(Opcional) Configurar la gestión de secretos

Encuentra y utiliza tus datos

Comandos admitidos del colector NRDOT

Gestión de servicios de Windows

Gestión de servicios de Linux

Resolución de problemas

Métricas disponibles

Métrica predeterminada

Métricas predeterminadas recopiladas por NRDOT Collector

Métricas adicionales

Instancia métrica

Métricas del grupo de búferes

Métricas de conexiones

Base de datos métrica

Métricas del clúster de conmutación por error

Métricas de bloqueo

Métricas de objetos bloqueados

Memoria métrica

Métricas de seguridad

Métricas de TempDB

Métricas del grupo de hilos

Métricas de conexiones de usuario

Métricas de estadísticas de espera

Que sigue

Requisitos previos