New Relic 이외의 서비스에 Domino 통계 게시
Domino는 Domino 통계를 New Relic에 게시하도록 사전 구성되지만 Hosted Graphite와 같은 다른 서비스에 게시하려는 경우 여러 notes.ini 설정을 사용하여 그렇게 할 수 있습니다.
프로시저
Domino 서버에서 다음 notes.ini 설정을 사용하여 통계를 New Relic이 아닌 서비스에 게시할 수 있습니다. 서비스에서는 HTTP POST 요청을 통해 시계열 데이터를 허용할 수 있어야 합니다.
설정 | 설명 | 필수 속성인지 여부 | 지원되는 대체 문자열1 |
---|---|---|---|
STATPUB_ENABLE=1 | Domino 통계 게시를 활성화합니다. | 필수 | 적용되지 않음 |
STATPUB_URI=<string> | 메트릭 서버의 URI입니다. | 필수 | $Timestamp$ |
STATPUB_METRIC_FORMAT=<string> | 카운터 메트릭에 사용할 형식입니다. | 필수 | $Name$ (required) $Value$ (required) $Timestamp$ $Newline$ |
STATPUB_DELTA_METRIC_FORMAT=<string> | 비율 메트릭에 사용할 형식입니다. | 필수 | $Name$ (required) $Value$ (required) $Timestamp$ $Newline$ |
STATPUB_HEADERS=<string> | 요청과 함께 발송할 HTTP 헤더입니다. | 선택사항 | $Timestamp$ $Newline$(헤더 사이에 사용) |
STATPUB_DATA_HEAD=<string> | 페이로드에서 메트릭 데이터 앞에 넣을 데이터입니다. | 선택사항 | $Timestamp$ $Newline$ |
STATPUB_DATA_TAIL=<string> | 페이로드에서 메트릭 데이터 뒤에 넣을 데이터입니다. | 선택사항 | $Timestamp$ $Newline$ |
STATPUB_METRIC_DELIMITER=<string> | 메트릭을 구분하는 데 사용할 구분 기호입니다. 지정하지 않으면 쉼표(,)가 사용됩니다. | 선택사항 | $Newline$ |
1대체 문자열의 주요 사항:
$Name$
은 Domino 통계 이름을 대체하고, $Value$
는 Domino 통계 값을 대체하고, $Timestamp$
는 현재 Domino 시간 소인 값(Unix Epoch 시간을 기준으로 하는 시간(초))을 대체하고, $Newline$
은 줄 바꾸기 문자를 대체합니다.
예
Hosted Graphite에 통계 게시
이 예제에서는 통계를 Hosted Graphite에 보고하는 간단한 구성을 보여 줍니다. Hosted Graphite의 최소 요구사항은 다음과 같습니다.
- URI의 일부로 지정되는 API 키
- 이름 및 값 쌍을 공백으로 구분하여 한 줄에 메트릭 하나씩 지정한 하나 이상의 메트릭을 포함하는 데이터 페이로드
서버 notes.ini 파일의 예제 설정:
;Enable Domino to publish metrics to Hosted Graphite
STATPUB_ENABLE=1
STATPUB_URI=http://d4692fb0-464f-5adc-8db3-d663c3bc341a@www.hostedgraphite.com/api/v1/sink
STATPUB_METRIC_FORMAT=Domino.mailserver01.$Name$ $Value$
STATPUB_DELTA_METRIC_FORMAT=Domino.mailserver01.Rate.$Name$ $Value$
STATPUB_METRIC_DELIMITER=$Newline$
다음 예제에서는
Mail.Delivered
통계의 데이터 페이로드에 포함된 2개의 메트릭을 보여 줍니다. 첫 번째는 Domino 서버가 시작된 이래 배달된 33065개의 메시지를 나타내고, 두 번째는 마지막 1분간 배달된 1017개 메시지를 나타냅니다. Domino.mailserver01.Mail.Delivered 33065
Domino.mailserver01.Rate.Mail.Delivered 1017
STATPUB_METRIC_DELIMITER=$Newline$
각 메트릭을 별도의 줄에 넣습니다.
New Relic에 통계 게시
다음 예제에서는 Domino에서 New Relic에 게시하는 데 사용하는 구성을 보여 주며, 이 구성을 다른 서비스에 맞게 조정할 수 있습니다. 이 구성은 HTTP 헤더와 통계 앞뒤에 추가 데이터를 포함하는 더 복잡한 구성을 설명하기 위한 것입니다.
주: New Relic을 사용하는 경우 Domino 서버에서는 API 요구사항을 기본적으로 알고 있으며 notes.ini 파일에 NEWRELIC_LICENSE_KEY 값을 설정할 때 필요에 따라 데이터의 형식을 자동으로 지정합니다.
주: 다음 예제에서는 읽기 편하게 두 줄에 표시된 설정을 보여 줍니다. 실제 notes.ini 파일에서는 각 설정이 한 줄에 있어야 합니다.
;Enable Domino to publish to New Relic
STATPUB_ENABLE=1
STATPUB_URI=http://platform-api.newrelic.com/platform/v1/metrics
STATPUB_HEADERS=X-License-Key: f83f53480dbcb06c0a07f62bc96aed05d0739f07$Newline$Content-Type:
application/json$Newline$Accept: application/json$Newline$
STATPUB_DATA_HEAD={"agent":{"host":"mailserver01.renovations.com","version":"1.0.0"},"components":
[{"name":"Mailserver01/Renovations","guid":"com.renovations.MyDominoStats","duration":60,"metrics":{
STATPUB_DATA_TAIL=}}]}
STATPUB_METRIC_FORMAT="Component/$Name$":$Value$
STATPUB_DELTA_METRIC_FORMAT="Component/Delta/$Name$":$Value$
이 예제에서
- New Relic 계정 라이센스 키는 세 개의 HTTP 헤더(한 줄에 하나) 중 하나에 포함됩니다.
- New Relic 플러그인 API에서는 메트릭 데이터를 JSON 형식을 사용하여 발송해야 합니다. 따라서
STATPUB_DATA_HEAD
매개변수를 사용하여 게시 서버의 호스트 이름 및 인스턴스 이름(Domino 서버 이름)를 포함하는 메타데이터와 함께 필요한 초기 JSON 구문을 지정합니다.STATPUB_DATA_TAIL
매개 변수는 데이터 페이로드의 JSON 구문을 닫는 데 필요한 문자를 정의합니다. STATPUB_METRIC_FORMAT
및STATPUB_DELTA_METRIC_FORMAT
은 페이로드의 일부로 발송되는 개별 메트릭에 사용되는 형식을 정의합니다.- STATPUB_METRIC_DELIMITER 설정을 사용하지 않으므로 기본 구분기호인 쉼표(,)가 메트릭 사이에 사용됩니다.