• EnglishEspañol日本語한국어Português
  • Inicia sesiónComenzar ahora

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

En caso de que haya discrepancias entre la versión en inglés y la versión traducida, se entiende que prevalece la versión en inglés. Visita esta página para obtener más información.

Crea una propuesta

Integración de monitoreo de StatsD

Nuestra integración de StatsD le permite obtener fácilmente datos en formato StatsDen New Relic. También puede agregar cualquier etiqueta arbitraria (pares de valores principales) a sus datos. Una vez que tus métricas estén en New Relic, podrás consultar tus datos y crear gráficos y paneles personalizados.

¿Quieres probar nuestra integración de StatsD? ¡ Crea una cuenta New Relic gratis! No se requiere tarjeta de crédito.

Requisitos

Esta integración utiliza nuestra API métrica y nuestra API de eventos para ingerir datos. Para utilizar estas API, necesitará un .

La integración cumple con los requisitos de API métrica y los límites de datos. Para ver si es posible que esté alcanzando el límite de velocidad, ejecute la siguiente consulta NRQL del eventoNrIntegrationError :

SELECT count(*) FROM NrIntegrationError
WHERE newRelicFeature = 'Metrics'
FACET category, message
LIMIT 100 SINCE 1 day ago

La integración está disponible como una imagen de contenedor de Linux en DockerHub para amd64 y arm64 arquitectura.

Instalar

Esta sección explicará cómo realizar una instalación estándar. Si desea ejecutar StatsD en Kubernetes, consulte Instalación de Kubernetes.

Para instalar la integración de StatsD, ejecute el siguiente comando e incluya su ID de cuenta de New Relic y . Esto genera un archivo de configuración TOML utilizado por gostatsd.

bash
$
docker run \
>
-d --restart unless-stopped \
>
--name newrelic-statsd \
>
-h $(hostname) \
>
-e NR_ACCOUNT_ID=YOUR_ACCOUNT_ID \
>
-e NR_API_KEY=NEW_RELIC_LICENSE_KEY \
>
-p 8125:8125/udp \
>
newrelic/nri-statsd:latest

Si su organización se encuentra en la región del centro de datos de la UE, agregue esto al comando anterior:

bash
$
-e NR_EU_REGION=true \

Después de la instalación, puedes:

Instalar para Kubernetes

A continuación se muestran ejemplos de manifiestos de Kubernetes para implementación y objetos de servicio:

¿Te ha ayudado este documento con la instalación?

Configurar

En el procedimiento de instalación, ejecuta nri-statsd con variables de entorno y esto genera un archivo de configuración TOML. Además, puede establecer estas opciones de configuración:

Opciones de configuración

Descripción

expiry-interval

cadena

Si una métrica no se actualiza durante este período de tiempo, dejamos de informar esa métrica. El valor predeterminado es 5m.

Si desea enviar la métrica solo si el valor se actualizó entre los intervalos de descarga, configúrelo en 1ms. Para nunca caducar métrica, configúrelo en 0.

percent-threshold

lista de números enteros

Especifica el percentil utilizado para la agregación métrica. Predeterminado: 90.

metrics-addr

cadena

Indica dirección en la que escuchar métrica. Predeterminado: :8125. Desde nri-statsd v2.3.0 (goStatsD v34.2.1), se admite la conexión a través de Unix dominio Socket (UDS). Emplee metrics-addr=/some/path/newrelic-statsd.socket en lugar de [host]:port en la configuración.

Sugerencia

Para garantizar el cumplimiento de FedRAMP al utilizar la integración de StatsD, debe definir el siguiente extremo en la configuración personalizada:

address = 'https://gov-insights-collector.newrelic.com/v1/accounts/$NR_ACCOUNT_ID/events'
address-metrics = 'https://gov-infra-api.newrelic.com/metric/v1'

A continuación se muestran algunos ejemplos de personalización de la configuración sobrescribiendo la configuración predeterminada:

Formato métrico

La integración recibe métrica utilizando el protocolo StatsD. Opcionalmente, se puede configurar la frecuencia de muestreo y agregar una etiqueta.

Este es el formato de datos métrico que utilizamos:

<metric name>:<value>|<type>|@<sample rate>|#<tags>

Aquí hay explicaciones de estos campos:

Nombre del campo

Descripción

<metric name>

cadena

Required. Nombre de la métrica.

<value>

cadena

Required. El tipo de métrica:

  • c = contador
  • g = medidor
  • ms = temporizador

@<sample rate>

Flotante

Optional para contadores simples o contadores temporizadores. Cuando se deben enviar muchas métricas, se puede utilizar el muestreo para reducir el tráfico de la red. La desventaja es una reducción en la resolución de los datos.

Un ejemplo de cómo funcionaría esto para frecuencias de muestreo inferiores a 1: si lo configura en 0.1, el contador enviará una medición una de cada 10 veces.

#<tags>

cadena

Optional. La etiqueta adjunta a su métrica se convierte en atributo (valor principal pares). Para obtener más información sobre las opciones de etiquetas, consulte etiqueta.

Tipos métricos

A continuación se detallan los tipos de métricas y cómo formatearlas:

Agregar etiqueta (atributo)

Puedes agregar una etiqueta a tus datos, que guardamos como atributo (valor principal pares). Hay dos opciones para agregar etiquetas:

  • Agregue una etiqueta predeterminada que se aplique a todas las métricas: Estas se aplican a todas las métricas. Son fijos y no cambian con el tiempo.
  • Agregar etiqueta de nivel de métrica: se aplican a métricas específicas y permiten cambiar el valor entre dos envíos.

A continuación se muestra un ejemplo de consulta NRQL que incluye una etiqueta personalizada:

SELECT count(*) FROM Metric WHERE environment = 'production'

Crear alerta

Puede alertar sobre datos de StatsD usando NRQL condición de alerta.

Buscar y utilizar datos

Para consultar tus datos, utilizarías cualquier opción de consulta de New Relic. Por ejemplo, podrías ejecutar una consulta NRQL como:

SELECT count(*) FROM Metric WHERE metricName = 'myMetric' and environment = 'production'

Para obtener más información sobre cómo consultar el tipo de datos Metric , consulte consulta métrica de datos.

Resolución de problemas

Problema:

Seguiste los pasos para ejecutar la integración de StatsD pero aún necesitas ver la métrica esperada en New Relic.

Soluciones:

Siga los pasos a continuación para solucionar problemas de su configuración:

  • Asegúrese de que contenga su clave de licencia de 40 caracteres hexadecimales y que sea una licencia válida para el ID de cuenta de New Relic seleccionado.
  • Asegúrese de que se haya seleccionado el centro de datos correcto, EE. UU. o UE, para su cuenta New Relic. Consejo: Si la clave_licencia comienza con "eu", entonces debe utilizar la marca NR_EU_REGION=true .
  • Asegúrese de que no haya ningún NrIntegrationError relacionado con la integración de StatsD.
  • El log detallado se puede habilitar usando la variable de entorno NR_STATSD_VERBOSE, modifique el comando de ejecución docker agregando la siguiente variable: -e NR_STATSD_VERBOSE=true.
  • Se puede enviar una prueba métrica para confirmar que la integración está enviando las métricas esperadas. Ejemplo de uso de la utilidad NetCat nc :
    • echo "example.gauge:123|g" | nc -u -w0 127.0.0.1 8125 (actualice 127.0.0.1 con la dirección IP/dirección del contenedor en ejecución).

Comprueba el código fuente

Esta integración es software de código abierto. Eso significa que puedes explorar su código fuente y enviar mejoras, o crear tu propia bifurcación y compilarla.

Copyright © 2024 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.