New Relic 이외의 서비스에 Domino 통계 게시

Domino는 Domino 통계를 New Relic에 게시하도록 사전 구성되지만 Hosted Graphite와 같은 다른 서비스에 게시하려는 경우 여러 notes.ini 설정을 사용하여 그렇게 할 수 있습니다.

프로시저

Domino 서버에서 다음 notes.ini 설정을 사용하여 통계를 New Relic이 아닌 서비스에 게시할 수 있습니다. 서비스에서는 HTTP POST 요청을 통해 시계열 데이터를 허용할 수 있어야 합니다.

표 1. 다른 서비스에 게시하는 데 사용하는 notes.ini 설정
설정	설명	필수 속성인지 여부	지원되는 대체 문자열¹
^{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$

¹대체 문자열의 주요 사항:

$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 설정을 사용하지 않으므로 기본 구분기호인 쉼표(,)가 메트릭 사이에 사용됩니다.