各エージェントの設定例

[更新: 2026年7月23日]

本ドキュメントでは、モニタリングスイートへメトリクス、ログ、トレースを送信する際の各エージェントの設定例を紹介します。

各ストレージへデータを送信するには、アクセスキーが必要です。アクセスキーの取得方法については、モニタリングスイートコントロールパネル操作ガイドを参照してください。

メトリクスの送信設定 

Prometheus 

アクセスキーの詳細画面に表示されているエンドポイントと認証情報を利用し、以下のように Prometheus の remote_write を設定します。

remote_write:
- url: "https://**********.metrics.monitoring.global.api.sacloud.jp/prometheus/api/v1/write"
  credentials: "********************"

OpenTelemetry Collector 

アクセスキーの詳細画面に表示されているエンドポイントと認証情報を利用し、以下のように OpenTelemetry Collector を設定します。

receivers については、お客様の環境に合わせて設定してください。 batch processor の値は目安です。お客様の環境に応じて調整してください。

receivers:
  ...

processors:
  batch:
    timeout: 15s
    send_batch_size: 2048
    send_batch_max_size: 4096

exporters:
  prometheusremotewrite/sakura-monitoring-suite-metrics:
    endpoint: https://**********.metrics.monitoring.global.api.sacloud.jp/prometheus/api/v1/write
    headers:
      Authorization: "Bearer **********"

service:
  pipelines:
    metrics:
      receivers:
        - ...
      processors:
        - batch
      exporters:
        - prometheusremotewrite/sakura-monitoring-suite-metrics

sacloud-otel-collector 

さくらのクラウドでは OpenTelemetry Collector をベースにした OSS の sacloud-otel-collector を提供しています。

sacloud-otel-collector にはモニタリングスイート専用の sacloudexporter を同梱しています。 sacloudexporter を利用することで、batch processor を利用しなくても、適切なサイズでリクエストが自動分割されてモニタリングスイートに送信されます。

詳細は sacloud-otel-collector の README をご確認ください。

メトリクスのクエリ設定 

Grafana など、ユーザが用意した監視ツールからクエリを行いたい場合は、以下のように Prometheus データソースを設定します。

URL: https://****.metrics.monitoring.global.api.sacloud.jp/prometheus/
ヘッダー: Key に Authorization、Value に Bearer ********** を指定

ログの送信設定 

Fluent Bit 

アクセスキーの詳細画面に表示されているエンドポイントと認証情報を利用し、以下のように Fluent Bit の OUTPUT を設定します。

[OUTPUT]
Name         opentelemetry
Match        *
Host         **********.logs.monitoring.global.api.sacloud.jp
Port         443
Tls          On
Logs_URI     /v1/logs
Header       Authorization Bearer **********

OpenTelemetry Collector 

アクセスキーの詳細画面に表示されているエンドポイントと認証情報を利用し、以下のように OpenTelemetry Collector を設定します。

receivers については、お客様の環境に合わせて設定してください。 batch processor の値は目安です。仕様・制限の書き込みレート制限にかからないよう、お客様の環境に応じて調整してください。

receivers:
  ...

processors:
  batch:
    timeout: 15s
    send_batch_size: 2048
    send_batch_max_size: 4096

exporters:
  otlphttp/sakura-monitoring-suite-logs:
    endpoint: https://**********.logs.monitoring.global.api.sacloud.jp
    headers:
      Authorization: "Bearer **********"

service:
  pipelines:
    logs:
      receivers:
        - ...
      processors:
        - batch
      exporters:
        - otlphttp/sakura-monitoring-suite-logs

sacloud-otel-collector 

さくらのクラウドでは OpenTelemetry Collector をベースにした OSS の sacloud-otel-collector を提供しています。

sacloud-otel-collector にはモニタリングスイート専用の sacloudexporter を同梱しています。 sacloudexporter を利用することで、batch processor を利用しなくても、適切なサイズでリクエストが自動分割されてモニタリングスイートに送信されます。

詳細は sacloud-otel-collector の README をご確認ください。

トレースの送信設定 

OpenTelemetry Collector 

アクセスキーの詳細画面に表示されているエンドポイントと認証情報を利用し、以下のように OpenTelemetry Collector を設定します。

receivers については、お客様の環境に合わせて設定してください。 batch processor の値は目安です。仕様・制限の書き込みレート制限にかからないよう、お客様の環境に応じて調整してください。

receivers:
  ...

processors:
  batch:
    timeout: 15s
    send_batch_size: 2048
    send_batch_max_size: 4096

exporters:
  otlphttp/sakura-monitoring-suite-traces:
    endpoint: https://****.traces.monitoring.global.api.sacloud.jp
    headers:
      Authorization: "Bearer **********"

service:
  pipelines:
    traces:
      receivers:
        - ...
      processors:
        - batch
      exporters:
        - otlphttp/sakura-monitoring-suite-traces

sacloud-otel-collector 

さくらのクラウドでは OpenTelemetry Collector をベースにした OSS の sacloud-otel-collector を提供しています。

sacloud-otel-collector にはモニタリングスイート専用の sacloudexporter を同梱しています。 sacloudexporter を利用することで、batch processor を利用しなくても、適切なサイズでリクエストが自動分割されてモニタリングスイートに送信されます。

詳細は sacloud-otel-collector の README をご確認ください。