• 로그인지금 시작하기

사용자의 편의를 위해 제공되는 기계 번역입니다.

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

문제 신고

StatsD 모니터링 통합

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

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

요구 사항

이 통합은 Metric APIEvent 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 통합을 설치하려면 다음 명령을 실행하고 New Relic 계정 IDNew Relic 라이선스 키 를 포함합니다. 그러면 gostatsd 에서 사용하는 TOML 구성 파일이 생성됩니다.

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

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

bash
$
-e NR_EU_REGION=true \

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

Kubernetes용 설치

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

While you wait for your data to come in...

Did this doc help you install?

구성

설치 절차 에서 환경 변수와 함께 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

필수의. 측정항목의 이름입니다.

<value>
string

필수의. 측정항목 유형 :

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

@<sample rate>
float

단순 카운터 또는 타이머 카운터의 경우 선택 사항 입니다. 많은 메트릭을 보내야 하는 경우 샘플링을 사용하여 네트워크 트래픽을 줄일 수 있습니다. 단점은 데이터 해상도의 감소입니다.

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

#<tags>
string

선택 과목. 메트릭에 연결된 태그는 속성(키-값 쌍)으로 변환됩니다. 태그 지정 옵션에 대한 자세한 내용은 태그 를 참조하십시오.

측정항목 유형

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

태그(속성) 추가

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

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

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

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

알림 생성

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

데이터 찾기 및 사용

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

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

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

소스 코드 확인

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

Copyright © 2022 New Relic Inc.

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