206.3.2 INGEST_METRICSファンクション

このファンクションを使用すると、ワークスペース内のユーザーは、データを一括でOracle AI Database Telemetry Streamingに取り込めます。

このINGEST_METRICSファンクションは、ネイティブJSON形式(テレメトリ・プロトコル)またはライン・プロトコル形式で書式設定して一括取込みを実行し、実行した取込みについての情報を含むJSONを戻します。

構文

ingest_metrics(
         metrics        IN  CLOB,
         status         OUT NUMBER,
         metrics_format IN  VARCHAR2 default 'telemetry protocol') -- Other value ‘line protocol’
return clob;

パラメータ

表206-3 INGEST_METRICSファンクションのパラメータ

パラメータ	説明
metrics	CLOBとして挿入する必要があるメトリック・データ
status	statusは、データが正常に取り込まれたかどうかを示します(201- 成功、400 - 失敗)
metrics_format	取込みに使用されるデータ形式。metrics_formatは、ネイティブJSON形式(テレメトリ・プロトコル)またはInflux DBライン・プロトコル形式にできます

次の例では、metrics_formatで使用されるテレメトリ・プロトコル形式およびライン・プロトコル形式を示します。

テレメトリ・プロトコルの例

形式:

{ "metrics" : [
                [<metric_name>, <tags as JSON>, <value>, <time in secs since epoch>],
                [<metric_name>, <tags as JSON>, <value>, <time in secs since epoch>]
                   ..
              ]
}

例:

{ "metrics" : [
                ["scrape_duration_seconds", {"http_scheme":"http","net_host_port":"2112"}, 0, 1704700084],
                ["scrape_samples_scraped", {"http_scheme":"http","net_host_port":"2112"}, 12, 1704700085]
                   ..
              ]
}

ライン・プロトコルの例

形式:

<measurement>[,<tag_key>=<tag_value>[,<tag_key>=<tag_value>]] <field_key>=<field_value>[,<field_key>=<field_value>] [<timestamp>]

例:

trig,host=phoenix92613 sine=0 1752215852000000000
mem,host=phoenix92613 sine=0 1752215852000000000