Supported OS Linux Mac OS Windows

Versión de la integración4.1.0

¡Ir al gráfico

Información general

Realiza un seguimiento del uso de memoria de tus servicios Go y recopila métricas instrumentadas desde el paquete Expvar Go.

Si prefieres instrumentar tu código Go utilizando sólo dogstats-go, todavía podrás utilizar esta integración para recopilar métricas relacionadas con la memoria.

Configuración

Instalación

El check de Expvar Go está incluido en el paquete del Agent, así que instala el Agent en cualquier lugar donde ejecutes servicios Go para recopilar métricas.

Configuración

Preparación del servicio

Si tu servicio Go no utiliza el paquete expvar, impórtalo (import "expvar"). Si no quieres instrumentar tus propias métricas con expvar, es decir, si sólo quieres recopilar métricas de memoria de tu servicio, importa el paquete utilizando el identificador en blanco (import _ "expvar"). Si tu servicio aún no escucha solicitudes HTTP (con el paquete http), haz que escuche localmente sólo al Datadog Agent.

Host

Para configurar este check para un Agent que se ejecuta en un host:

Conexión del Agent
  1. Edita el archivo go_expvar.d/conf.yaml, que se encuentra en la carpeta conf.d/ en la raíz del directorio de configuración de tu Agent. Para conocer todas las opciones de configuración disponibles, consulta el go_expvar.d/conf.yaml de ejemplo:

    Nota: Si no configuras una lista de metrics, el Agent sigue recopilando métricas memstat. Utiliza metrics para indicar al Agent qué variables expvar debe recopilar.

  2. Reinicia el Agent.

Nota: La integración Expvar Go puede potencialmente emitir métricas personalizadas, lo que puede afectar a tu facturación. Por defecto, existe un límite de 350 métricas. Si necesitas más métricas, ponte en contacto con el servicio de asistencia de Datadog.

En contenedores

Para entornos en contenedores, consulta las plantillas de integración de Autodiscovery para obtener orientación sobre la aplicación de los parámetros que se indican a continuación.

ParámetroValor
<INTEGRATION_NAME>go_expvar
<INIT_CONFIG>en blanco o {}
<INSTANCE_CONFIG>{"expvar_url": "http://%%host%%:8080"}

Validación

Ejecuta el subcomando de estado del Agent y busca go_expvar en la sección Checks.

Datos recopilados

Métricas

go_expvar.memstats.alloc
(gauge)
Bytes allocated and not yet freed
Shown as byte
go_expvar.memstats.frees
(gauge)
Number of frees
Shown as operation
go_expvar.memstats.heap_alloc
(gauge)
Bytes allocated and not yet freed
Shown as byte
go_expvar.memstats.heap_idle
(gauge)
Bytes in idle spans
Shown as byte
go_expvar.memstats.heap_inuse
(gauge)
Bytes in non-idle spans
Shown as byte
go_expvar.memstats.heap_objects
(gauge)
Total number of allocated objects
Shown as item
go_expvar.memstats.heap_released
(gauge)
Bytes released to the OS
Shown as byte
go_expvar.memstats.heap_sys
(gauge)
Bytes obtained from system
Shown as byte
go_expvar.memstats.lookups
(gauge)
Number of pointer lookups
Shown as operation
go_expvar.memstats.mallocs
(gauge)
Number of mallocs
Shown as operation
go_expvar.memstats.num_gc
(gauge)
Number of garbage collections
Shown as garbage collection
go_expvar.memstats.pause_ns.95percentile
(gauge)
95th percentile of recent GC pause durations
Shown as nanosecond
go_expvar.memstats.pause_ns.avg
(gauge)
Average of recent GC pause durations
Shown as nanosecond
go_expvar.memstats.pause_ns.count
(rate)
Number of submitted GC pause durations
Shown as sample
go_expvar.memstats.pause_ns.max
(gauge)
Max GC pause duration
Shown as nanosecond
go_expvar.memstats.pause_ns.median
(gauge)
Median GC pause duration
Shown as nanosecond
go_expvar.memstats.pause_total_ns
(gauge)
Total GC pause duration over lifetime of process
Shown as nanosecond
go_expvar.memstats.total_alloc
(gauge)
Bytes allocated (even if freed)
Shown as byte
go_expvar.memstats.total_alloc.count
(count)
Bytes allocated (even if freed) as monotonic count
Shown as byte

Eventos

El check de Expvar Go no incluye eventos.

Checks de servicio

El check de Expvar Go no incluye checks de servicio.

Solucionar problemas

¿Necesitas ayuda? Ponte en contacto con el servicio de asistencia de Datadog.

Referencias adicionales