• EnglishEspañol日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Integração de monitoramento StatsD

Nossa integração StatsD permite que você obtenha facilmente dados no formato StatsDpara o New Relic. Você também pode adicionar qualquer tag arbitrária (pares de valores principais) aos seus dados. Uma vez que suas métricas estejam no New Relic, você pode consultar seus dados e criar gráficos e dashboards personalizados.

Quer experimentar nossa integração StatsD? Crie uma conta New Relic gratuitamente! Não é necessário cartão de crédito.

Requisitos

Esta integração utiliza nossa API métrica e nossa API evento para ingerir dados. Para usar essas API, você precisará de um .

A integração atende aos requisitos e limites de dados da API métrica. Para ver se você está atingindo o limite de taxa, execute a seguinte consulta NRQL do eventoNrIntegrationError :

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

A integração está disponível como imagem de contêiner Linux no DockerHub para AMD64 e Arm64 Arquitetura.

Instalar

Esta seção explicará como fazer uma instalação padrão. Se você deseja executar o StatsD no Kubernetes, consulte Instalação do Kubernetes.

Para instalar a integração StatsD, execute o comando a seguir e inclua o ID da sua conta New Relic e . Isso gera um arquivo de configuração TOML usado 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

Se sua organização estiver na região de data center da UE, adicione isto ao comando acima:

bash
$
-e NR_EU_REGION=true \

Após a instalação, você pode:

Instalar para Kubernetes

Aqui estão exemplos de manifestos do Kubernetes para objetos de implantação e serviço:

Este documento ajudou você na instalação?

Configurar

No procedimento de instalação, você executa nri-statsd com variáveis de ambiente e isso gera um arquivo de configuração TOML. Além disso, você pode definir estas opções de configuração:

Opções de configuração

Descrição

expiry-interval

corda

Se uma métrica não for atualizada durante esse período, paramos de reportar essa métrica. O padrão é 5m.

Caso queira enviar a métrica apenas se o valor foi atualizado entre os intervalos de flush, configure para 1ms. Para nunca expirar a métrica, configure-a para 0.

percent-threshold

Lista de inteiros

Especifica o percentil usado para agregação métrica. Padrão: 90.

metrics-addr

corda

Indica o endereço onde será escutada a métrica. Padrão: :8125. A partir de nri-statsd v2.3.0 (goStatsD v34.2.1), a conexão via soquete de domínio Unix (UDS) é suportada. Use metrics-addr=/some/path/newrelic-statsd.socket em vez de [host]:port na configuração.

Dica

Para garantir a conformidade do FedRAMP ao usar a integração StatsD, você deve definir o seguinte endpoint na configuração personalizada:

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

Aqui estão alguns exemplos de personalização da configuração substituindo a configuração padrão:

Formato métrico

A integração recebe métricas utilizando o protocolo StatsD. Opcionalmente, a taxa de amostragem pode ser configurada e a tag pode ser adicionada.

Aqui está o formato de dados métricos que usamos:

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

Aqui estão as explicações desses campos:

Nome do campo

Descrição

<metric name>

corda

Required. Nome da métrica.

<value>

corda

Required. O tipo de métrica:

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

@<sample rate>

float

Optional para contadores simples ou contadores temporizadores. Quando muitas métricas devem ser enviadas, você pode usar amostragem para reduzir o tráfego de rede. A desvantagem é a redução na resolução dos dados.

Um exemplo de como isso funcionaria para taxas de amostragem abaixo 1: se você definir isso como 0.1, o contador enviaria uma medição uma em cada 10 vezes.

#<tags>

corda

Optional. Tag anexada à sua métrica são convertidas em atributo (pares de valor principal). Para obter mais informações sobre opções de tags, consulte tag.

Tipos métricos

Aqui estão os tipos de métricas e como formatá-las:

Adicionar tag (atributo)

Você pode adicionar tag aos seus dados, que salvamos como atributo (pares de valor principal). Existem duas opções para adicionar tag:

  • Adicionar tag padrão que se aplica a todas as métricas: Aplica-se a todas as métricas. Eles são fixos e não mudam com o tempo.
  • Adicionar tag de nível métrico: aplicam-se a métricas específicas e permitem que o valor seja alterado entre dois envios.

Aqui está um exemplo de consulta NRQL que inclui uma tag personalizada:

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

Criar alerta

Você pode alertar sobre dados StatsD usando NRQL condição do alerta.

Encontre e use dados

Para consultar seus dados, você usaria qualquer opção de consulta do New Relic. Por exemplo, você pode executar uma consulta NRQL como:

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

Para mais informações sobre como consultar o tipo de dados Metric , consulte consulta métrica de dados.

Resolução de problemas

Problema:

Você seguiu as etapas para executar a integração do StatsD, mas ainda precisa ver a métrica esperada no New Relic.

Soluções:

Siga as etapas abaixo para solucionar problemas de sua configuração:

  • Certifique-se de que contenha sua chave de licença de 40 caracteres hexadecimais e seja uma licença válida para o ID de conta New Relic selecionado.
  • Certifique-se de que o data center correto, dos EUA ou da UE, foi selecionado para sua conta New Relic. Dica: se a chave_de_licença começar com "eu", você deverá usar a sinalização NR_EU_REGION=true .
  • Certifique-se de que não haja NrIntegrationError relacionados à integração do StatsD.
  • O log detalhado pode ser habilitado usando a variável de ambiente NR_STATSD_VERBOSE, modifique o comando docker run adicionando a seguinte variável: -e NR_STATSD_VERBOSE=true.
  • Uma métrica de teste pode ser enviada para confirmar se a integração está enviando as métricas esperadas. Exemplo usando o utilitário NetCat nc :
    • echo "example.gauge:123|g" | nc -u -w0 127.0.0.1 8125 (atualize 127.0.0.1 com o IP/endereço do contêiner em execução).

Verifique o código-fonte

Esta integração é um software de código aberto. Isso significa que você pode navegar pelo código-fonte e enviar melhorias, ou criar seu próprio fork e construí-lo.

Copyright © 2024 New Relic Inc.

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