:データの書き込み

タイムスタンプのルール

TSDB は、タイムスタンプの数値に基づいて、それが秒単位かミリ秒単位かを自動的に判別します。/api/put および /api/query の両方で、同じルールが適用されます。

シンプルモード（デフォルト）

モードを指定せずにリクエストを送信します。

• 成功時：HTTP 204、レスポンスボディなし

• 失敗時：HTTP エラーコードおよびエラーメッセージ

オーバーヘッドを最小限に抑えたい一般的なモニタリングデータの送信にこのモードを使用します。

統計モード

成功および失敗の件数を取得するには、?summary を追加します。

POST /api/put?summary

応答パラメーター：

応答例：

{
  "failed": 0,
  "success": 20
}

書き込まれたデータポイントの件数を追跡したい場合にこのモードを使用します。

詳細モード

成功および失敗の件数に加えてエラー情報を取得するには、?details を追加します。詳細モードは統計モードの拡張です。

POST /api/put?details

応答パラメーター：

応答例：

{
  "errors": [
    {
      "datapoint": {
        "metric": "sys.cpu.nice",
        "timestamp": 1365465600,
        "value": "NaN",
        "tags": {"host": "web01"}
      },
      "error": "Unable to parse value to a number"
    }
  ],
  "failed": 1,
  "success": 0
}

書き込み失敗の原因を特定したい場合にこのモードを使用します。

フォールトトレラントモード

1 つのデータポイントの書き込みが失敗しても、残りのデータポイントの書き込みを継続できるようにするには、?ignoreErrors を追加します。

POST /api/put?ignoreErrors

応答パラメーター：

書き込まれるデータポイントの件数を最大化し、個々の失敗を別途処理したい場合にこのモードを使用します。

時系列ごとの最大タグキー数

単一の時系列におけるタグキーの最大数は、インスタンスタイプによって異なります。

文字列値

文字列値には任意の文字を含めることができ、JSON 形式で保存できます。文字列値の最大サイズは 20 KB です。