• EnglishEspañol日本語한국어Português
  • 로그인지금 시작하기

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

영문본과 번역본이 일치하지 않는 경우 영문본이 우선합니다. 보다 자세한 내용은 이 페이지를 방문하시기 바랍니다.

문제 신고

StatsD 모니터링 통합

StatsD 통합을 통해 StatsD 형식 데이터를 New Relic으로 쉽게 가져올 수 있습니다. 데이터에 임의의 태그(키-값 쌍)를 추가할 수도 있습니다. 메트릭이 New Relic에 있으면 데이터를 쿼리 하고 사용자 지정 차트와 대시보드를 만들 수 있습니다.

StatsD 통합을 시도하고 싶으십니까? 무료 로 New Relic 계정을 만드 십시오! 신용 카드가 필요하지 않습니다.

요구 사항

이 통합은 지표 API이벤트 API를 사용하여 데이터를 수집합니다. 이러한 API를 사용하려면 이 필요합니다.

통합은 Metric API 요구 사항 및 데이터 제한을준수합니다. 속도 제한에 도달했는지 확인하려면 NrIntegrationError 이벤트의 다음 NRQL 쿼리를 실행하세요.

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

통합은 amd64 및 arm64 아키텍처용 DockerHub 에서 Linux 컨테이너 이미지로 사용할 수 있습니다.

설치

이 섹션에서는 표준 설치를 수행하는 방법을 설명합니다. Kubernetes에서 StatsD를 실행 하려면 Kubernetes 설치 를 참조하세요.

StatsD 통합을 설치하려면 다음 명령을 실행하고 뉴렐릭 계정 ID을 포함하세요. 그러면 gostatsd 에서 사용하는 TOML 설정 파일이 생성됩니다.

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

조직이 EU 데이터 센터 지역에 있는 경우 위 명령에 다음을 추가합니다.

bash
$
-e NR_EU_REGION=true \

설치 후 다음을 수행할 수 있습니다.

Kubernetes용 설치

다음은 배포 및 서비스 개체에 대한 Kubernetes 매니페스트의 예입니다.

이 문서가 설치하는데 도움이 되셨나요?

구성

설치 절차 에서 환경 변수와 함께 nri-statsd 을 실행하면 TOML 구성 파일이 생성됩니다. 또한 다음 구성 옵션을 설정할 수 있습니다.

구성 옵션

설명

expiry-interval

이 시간 동안 메트릭이 업데이트되지 않으면 해당 메트릭 보고가 중지됩니다. 기본값은 5m 입니다.

플러시 간격 사이에 값이 업데이트된 경우에만 측정항목을 보내려면 이를 1ms 으로 구성합니다. 측정항목을 만료하지 않으려면 0 로 설정하십시오.

percent-threshold

정수 목록

메트릭 집계에 사용되는 백분위수를 지정합니다. 기본값: 90 .

metrics-addr

메트릭을 수신할 주소를 나타냅니다. 기본값: :8125 . nri-statsd v2.3.0 (goStatsD v34.2.1 )에서 Unix 도메인 소켓(UDS)을 통한 연결이 지원됩니다. 구성에서 "[host]:port" 대신 "metrics-addr=/some/path/newrelic-statsd.socket"을 사용하십시오.

StatsD 통합을 사용할 때 FedRAMP 준수를 보장하려면 사용자 지정 구성에서 다음 끝점을 정의해야 합니다.

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

다음은 기본 구성을 덮어써서 구성을 사용자 지정하는 몇 가지 예입니다.

미터법 형식

통합은 StatsD 프로토콜 을 사용하여 메트릭을 수신합니다. 선택적으로 샘플 속도를 구성하고 태그를 추가할 수 있습니다.

다음은 우리가 사용하는 메트릭 데이터 형식입니다.

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

다음은 이러한 필드에 대한 설명입니다.

분야 명

설명

<metric name>
string

Required. 지표의 이름입니다.

<value>
string

Required. 지표 유형:

  • c = 카운터
  • g = 게이지
  • ms = 타이머

@<sample rate>
float

Optional 간단한 카운터 또는 타이머 카운터의 경우. 많은 지표를 전송해야 하는 경우 샘플링을 사용하여 네트워크 트래픽을 줄일 수 있습니다. 단점은 데이터 해상도가 감소한다는 것입니다.

이것이 1 미만의 샘플 레이트에서 작동하는 방식의 예: 이 값을 0.1 로 설정하면 카운터는 10번 중 1번 측정값을 보냅니다.

#<tags>
string

Optional. 지표에 첨부된 태그는 속성(핵심 가치 쌍)으로 변환됩니다. 태그 지정 옵션에 대한 자세한 내용은 태그 를 참조하세요.

측정항목 유형

다음은 측정항목의 유형과 형식을 지정하는 방법입니다.

태그(속성) 추가

속성 (키-값 쌍)으로 저장하는 데이터에 태그를 추가할 수 있습니다. 태그 추가에는 두 가지 옵션이 있습니다.

  • 모든 메트릭에 적용되는 기본 태그 추가: 모든 메트릭에 적용됩니다. 그것들은 고정되어 있으며 시간이 지나도 변하지 않습니다.
  • 메트릭 수준 태그 추가: 특정 메트릭에 적용되며 두 제출 간에 값을 변경할 수 있습니다.

다음은 사용자 지정 태그가 포함된 NRQL 쿼리의 예입니다.

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

알림 생성

NRQL 경고 조건 을 사용하여 StatsD 데이터에 대해 경고할 수 있습니다.

데이터 찾기 및 사용

데이터를 쿼리하려면 New Relic 쿼리 옵션을 사용합니다. 예를 들어 다음과 같은 NRQL 쿼리를 실행할 수 있습니다.

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

Metric 데이터 유형을 쿼리하는 방법에 대한 자세한 내용은 측정항목 데이터 쿼리 를 참조하세요.

문제점 해결

문제:

StatsD 통합을 실행하는 단계를 따랐지만 여전히 뉴렐릭에서 예상 지표를 확인해야 합니다.

솔루션:

설정 문제를 해결하려면 아래 단계를 따르세요.

  • 에 40자리 16진수 라이선스 키가 포함되어 있고 선택한 뉴렐릭 계정 ID에 대한 유효한 라이선스인지 확인하세요.

  • 귀하의 뉴렐릭 계정에 대해 올바른 데이터 센터(미국 또는 EU)가 선택되었는지 확인하세요. 팁: License_key가 "eu"로 시작하는 경우 NR_EU_REGION=true 플래그를 사용해야 합니다.

  • StatsD 통합과 관련된 NrIntegrationError 없는지 확인하세요.

  • 자세한 로그는 환경 변수 NR_STATSD_VERBOSE 을 사용하여 활성화할 수 있습니다. 다음 변수를 추가하여 docker run 명령을 수정합니다: -e NR_STATSD_VERBOSE=true.

  • 통합이 예상한 지표를 보내고 있는지 확인하기 위해 테스트 지표를 푸시할 수 있습니다. NetCat nc 유틸리티 사용 예:

    • echo "example.gauge:123|g" | nc -u -w0 127.0.0.1 8125 (실행 중인 컨테이너 IP/주소로 127.0.0.1 업데이트)

소스 코드 확인

이 통합은 오픈 소스 소프트웨어입니다. 즉 , 소스 코드를 탐색하고 개선 사항을 보내거나 고유한 포크를 만들어 빌드할 수 있습니다.

Copyright © 2024 New Relic Inc.

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