將 Domino 統計資料發佈至 New Relic 以外的服務

Domino 預先配置為將 Domino 統計資料發佈至 New Relic，但是如果您想要發佈至其他服務，例如 Hosted Graphite，有數個 notes.ini 設定可讓您用來進行發佈。

程序

使用 Domino 伺服器上的下列 notes.ini 設定，將它的統計資料發佈至非 New Relic 的服務。服務必須能夠透過 HTTP POST 要求接受時間序列資料。
表 1. 用來發佈至其他服務的 notes.ini 設定
設定 說明 必要？ 支援的替代字串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 設定。