將 Domino 統計資料發佈至 New Relic 以外的服務
Domino 預先配置為將 Domino 統計資料發佈至 New Relic,但是如果您想要發佈至其他服務,例如 Hosted Graphite,有數個 notes.ini 設定可讓您用來進行發佈。
程序
使用 Domino 伺服器上的下列 notes.ini 設定,將它的統計資料發佈至非 New Relic 的服務。服務必須能夠透過 HTTP POST 要求接受時間序列資料。
設定 | 說明 | 必要? | 支援的替代字串1 |
---|---|---|---|
STATPUB_啟用=1 | 啟用 Domino 統計資料發佈。 | 必要的 | 不適用 |
STATPUB_URI=<string> | 度量伺服器的 URI | 必要的 | $Timestamp$ |
STATPUB_METRIC_格式=<string> | 用於計數器度量的格式。 | 必要的 | $名稱$(必要)$Value$(必要)$Timestamp$ $Newline$ |
STATPUB_DELTA_METRIC_格式=<string> | 用於比率度量的格式。 | 必要的 | $名稱$(必要)$Value$(必要)$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 有下列最低需求:
- API 金鑰指定為 URI 的一部分
- 一或多個度量的資料有效負載指定為名稱與值配對(以空格區隔),每行一個度量。
伺服器 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
統計資料的資料有效負載中包含的兩個度量:第一個度量指出自從 Domino 伺服器啟動之後,已傳送 33065 則訊息,第二個度量指出在最後一分鐘傳送 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
參數是用來指定必要的起始 JSON 語法以及中繼資料,包括發佈伺服器的主機名稱和實例名稱(Domino 伺服器名稱)。STATPUB_DATA_TAIL
參數會定義必要的字元,用來結束資料有效負載的 JSON 語法。 STATPUB_METRIC_FORMAT
和STATPUB_DELTA_METRIC_FORMAT
會定義用於個別度量(在有效負載中傳送)的格式。- 會在度量之間使用預設定界符號(逗點 (,)),因為未使用 STATPUB_METRIC_DELIMITER 設定。