モニタリングスイート サービス基本情報

[更新: 2026年7月23日]

概要

モニタリングスイートは、システム監視を行うためのプラットフォームです。さくらのクラウド・その他のクラウド・オンプレ等の多様な環境を一元管理し、可視化することができます。

用語説明

ログストレージ・メトリクスストレージ・トレースストレージ

モニタリングスイートのデータを蓄積するためのストレージです。ログストレージはログデータを、メトリクスストレージは数値データを、トレースストレージはトレースデータを保存します。 ストレージ毎にアクセス制御やデータ保持ポリシーが異なるため、用途に応じてストレージを使い分けることを想定しています。

ログルーティング・メトリクスルーティング

さくらのクラウドの各種サービスからのログやメトリクスを、モニタリングスイートのストレージに送信するための設定です。

アラートプロジェクト

アラートプロジェクトは、アラートの設定を管理するための単位です。アラートルールを定義し、メトリクスの状態に基づいて通知を行います。

アラートプロジェクトには以下のリソース・機能が含まれます。

ルール

メトリクスの状態を監視し、条件に基づいてアラートを発生させるための設定です。

通知先

アラートが発生した際に通知を受け取るための設定です。現在は通知先としてシンプル通知とEventBusが選択可能です。

通知ルーティング

アラートの通知をどの通知先に送信するかを定義する設定です。再送設定やルール・ラベル等に基づくフィルタが設定可能です。

ログ計測ルール

条件にマッチしたログの行数をメトリクスストレージに格納する設定です。他の機能と組み合わせることで、ログに対するアラートを実現できます。

ダッシュボードプロジェクト

ダッシュボードプロジェクトは、ダッシュボードの設定を管理するための単位です。一つのダッシュボードプロジェクト中に複数のダッシュボードを作成できます。 メトリクストレージをデータソースとして利用します。

ユーザ領域・システム領域

モニタリングスイートでは、ログ・メトリクスのストレージ領域を「ユーザ領域」と「システム領域」に分けています。 トレースストレージは「ユーザ領域」のみの提供となります。

ユーザ領域

お客様が設定したログ・メトリクスを保存する領域です。ユーザが自由に作成・管理できます。 ユーザの環境で発生するカスタムログ・メトリクス・トレースを保存することが可能な領域です。 利用料金は、書き込みリクエスト量と保存期間に基づいて課金されます。

システム領域

さくらのクラウドが提供する機能のログ・メトリクスを保存する領域です。 無料で提供され、課金対象にはなりません。 ストレージの削除・アクセスキーの発行・保存期間の変更等の操作を行うことはできません。

共用プラン・専有プラン

ログ・トレースストレージには「共用プラン」と「専有プラン」の二つのストレージプランがあります。 ユーザ領域のストレージを作成する際に、どちらかのプランを選択する必要があります。 システム領域のストレージは共用プランのみの提供となります。

プランによって基本料金が異なります。 プランは後から変更することができませんので、用途に応じて適切なプランを選択してください。

共用プラン

保存先であるオブジェクトストレージのバケットをマルチテナントで共用する方式です。論理的にテナント分離されているため、他のテナントのデータにアクセスすることはできません。

専有プラン

保存先であるオブジェクトストレージのバケットを一つのテナントが専有する方式です。共用プランと比較して、ストレージあたりの保存上限容量が大きい、データ取り込み速度が速い、保存時のデータ暗号化が可能といったメリットがあります。

機能説明

モニタリングスイートは、以下の機能を提供します。

機能名

内容

メトリクス

システムの状態を数値で表現したデータを蓄積し、クエリできます。
Prometheus,opentelemetry-collector等のソフトウェアと連携することが可能です。

ログ

システムのログを収集し、検索や可視化ができます。
fluentbit,opentelemetry-collector等のソフトウェアと連携することが可能です。

トレース

分散トレーシングのデータを収集し、可視化ができます。
opentelemetry-collector等のソフトウェアと連携することが可能です。

ダッシュボード

メトリクスをダッシュボードで可視化します。

アラート

メトリクスの内容を監視し、閾値を超えた場合に通知を行います。

仕様・制限

メトリクスストレージ

項目

内容

保存期間

40日

ストレージあたりの保存上限の目安

1GB程度

1プロジェクトあたりの作成数

5

書き込みレート制限

1時間あたり5,000の新規Series

クエリレート制限

1時間あたり10,000回のクエリ

ペイロードサイズ制限

―

行サイズ制限

―

受け入れタイムスタンプ

現在時刻から48時間後以内

送信プロトコル

Prometheus Remote Write 1.0

読み出しプロトコル

Prometheus HTTP API

保管場所

石狩リージョン

ログ・トレースストレージ

項目

共用プラン

専有プラン

保存期間

40日(1~730日に変更可能)

40日(1~730日に変更可能)

ストレージあたりの保存上限の目安

100GB程度

5TB程度

1プロジェクトあたりの作成数

5

1

書き込みレート制限

1秒あたり50リクエスト・1,000行の書き込み

1秒あたり50リクエスト・1,000行の書き込み

クエリレート制限

1分あたり100回のクエリ

1分あたり100回のクエリ

ペイロードサイズ制限

1リクエストあたり5MiB（非圧縮時）

1リクエストあたり5MiB（非圧縮時）

行サイズ制限

1行あたり1MiB (メタデータ含む)

1行あたり1MiB (メタデータ含む)

受け入れタイムスタンプ

現在時刻の72時間前から1時間後以内

現在時刻の72時間前から1時間後以内

送信プロトコル

OpenTelemetry Protocol (OTLP/HTTP)

OpenTelemetry Protocol (OTLP/HTTP)

読み出しプロトコル

サポートなし

サポートなし

保存データの暗号化

サポートなし

サポートあり

保管場所

石狩リージョン

東京リージョン

アラートプロジェクト

項目

内容

プロジェクト作成数

5

各プロジェクト内のルール作成数

100

各プロジェクト内のログ計測ルール作成数

100

ダッシュボードプロジェクト

項目

内容

ダッシュボード作成数

5

データ暗号化

通信の暗号化

SSL/TLSプロトコルにより、通信経路上のデータは暗号化されます。

保存時の暗号化

ログ・トレースストレージの専有プランのみ暗号化が可能です。 さくらのクラウドの KMS（Key Management Service） で作成したKMSキーを利用したサーバサイド暗号化（SSE-KMS）に対応しています。 暗号化の設定はストレージ作成時に行う必要があります。作成後に暗号化の設定を変更することはできません。 暗号化に利用しているKMSキーを削除・無効化すると、そのストレージへの読み書きは不可能になります。内部キャッシュにより、KMSキーのステータス変更の影響は最大で 24h 遅延する可能性があります。

ログの構造化

モニタリングスイートでは非構造ログ/構造化ログの両方をサポートしています。構造化ログとして送る場合は、ログ行をパースしてマップに変換した上で送信します。 以下の対応表に従いフィールド名を設定すると、Web UI上で見やすくなり、検索やフィルタリング出来るようになります。

UI上の表示名

送信フィールド名

型

例

log_name

log_name

String

"my-log-name"

timestamp

time, timestamp

Integer / Double /
String

1728986923 / 1728986923123456789 /
1728986923.123457 / "2021-01-01T00:00:00.123456789Z"

severity

level, severity

String

"DEBUG", "INFO", "NOTICE",
"WARNING", "WARN", "ERROR",
"CRITICAL", "ALERT", "EMERGENCY", "DEFAULT"

http_request_method

http_request_method

String

"GET"

http_request_url

http_request_url, http_request_uri

String

"https://example.com/path"

http_request_size

http_request_size

Integer

1234

http_status

http_status_code, http_status
http_response_status_code

Integer

200

http_response_size

http_response_size

Integer

1234

http_user_agent

http_user_agent, user_agent

String

"Mozilla/5.0"

http_remote_ip

http_remote_addr, http_remote_ip

String

"203.0.113.1"

http_remote_port

http_remote_port

Integer

12345

http_referer

http_referer

String

"https://example.com/previous"

http_latency_ns

http_latency_ns, http_latency_us
http_latency_ms, http_latency_sec

Integer / Double

1234 / 1234.567890

http_cache_lookup

http_cache_lookup

Boolean

true

http_cache_hit

http_cache_hit

Boolean

true

http_cache_fill_bytes

http_cache_fill_bytes

Integer

1234

http_protocol

http_protocol

String

"HTTP/1.1"

http_schema

http_scheme, http_schema

String

"http"

http_user

http_user

String

"alice"

labels

_labels, __labels

map[string]string

{"key1": "value1", "key2": "value2"}

source_loc_file

source.file, source_file

String

"main.go"

source_line

source.line, source_line

String

"123"

source_function

source.function, source_function

String

"main.main"

text_payload

msg, message, text, log

String

"hello"

json_payload

上記のいずれにも該当しないフィールド

Object

{"foo": "bar", "num": 123}

OTLPログにおける特別なフィールドと、UI 上での対応する表示名との対応関係は以下の通りです。

UI上の表示名

OTLPフィールド名

型

例

trace_id

trace_id

String

"1234567890abcdef1234567890abcdef"

span_id

span_id

String

"1234567890abcdef"

service_name

resource_attributes["service.name"]

String

"my-service"

service_instance_id

resource_attributes["service.instance.id"]

String

"instance-001"

service_namespace

resource_attributes["service.namespace"]

String

"my-namespace"

service_version

resource_attributes["service.version"]

String

"1.0.0"

deployment_environment_name

resource_attributes["deployment.environment.name"]

String

"production"

resource_attributes

上記のいずれにも該当しないresource_attributesフィールド

Object

{"foo": "bar", "num": 123}

attributes

attributes

Object

{"foo": "bar", "num": 123}

Query機能

注釈

Query機能は試験運用中です。クエリ形式は今後変更される可能性があります。ご利用の際は最新のマニュアルをご確認ください。

クエリに使用できるフィールド

ログ

「ログの構造化」の表に記載のフィールド（timestamp, labels, severity を除く）が利用できます。 json_payload, attributes, resource_attributes 等の Object 型のフィールドは全体で一つの JSON 文字列として扱われます。

さくらのクラウドの他のマネージドサービスから連携されるログでは以下のフィールドも利用できます。

フィールド名

型

説明

例

sakuracloud_publisher

String

連携元サービス名

"nosql"

sakuracloud_variant

String

連携元サービスのログ種別

"systemlog"

sakuracloud_resource

Integer

連携元サービスのリソースID

123456789012

トレース

以下のスパンのフィールドを指定できます。 attributes, resource_attributes等のObject型のフィールドは全体で一つのJSON文字列として扱われます。

フィールド名

OTLPフィールド

型

例

trace_id

trace_id

String

"1234567890abcdef1234567890abcdef"

span_id

span_id

String

"1234567890abcdef"

parent_span_id

parent_span_id

String

"1234567890abcdef"

span_name

name

String

"GET /api/v1/resource"

span_kind

kind

String

"INTERNAL", "SERVER", "CLIENT", "PRODUCER", "CONSUMER"

span_status_code_text

status.code

String

"OK", "ERROR", "UNSET"

span_status_message

status.message

String

"Timeout error"

span_duration_unix_nano

end_time_unix_nano - start_time_unix_nano

Integer

1500000

service_name

resource_attributes["service.name"]

String

"my-service"

service_instance_id

resource_attributes["service.instance.id"]

String

"instance-001"

service_namespace

resource_attributes["service.namespace"]

String

"my-namespace"

service_version

resource_attributes["service.version"]

String

"1.0.0"

deployment_environment_name

resource_attributes["deployment.environment.name"]

String

"production"

resource_attributes

上記のいずれにも該当しないresource_attributesフィールド

Object

{"foo": "bar", "num": 123}

attributes

attributes

Object

{"foo": "bar", "num": 123}

クエリに使用できる演算子

演算子

意味

サポートしている型

記述例

=

等しい

Integer / Double / String / Boolean

log_name = "stdout", span_kind = "CLIENT"

!=

等しくない

Integer / Double / String / Boolean

http_status != 200, span_status_code_text != "ERROR"

>, <, >=, <=

大小比較

Integer / Double / String(辞書順)

http_latency_ns > 1000000, span_duration_unix_nano > 1000000

like

部分一致

String

text_payload like "%ERROR%", attributes like "%user.id%"

ilike

大文字小文字無視の部分一致

String

text_payload ilike "%error%", span_status_message ilike "%error%"

in

複数値のいずれかに一致

Integer / Double / String

http_status in (403, 404), span_kind in ("CLIENT", "SERVER")

複数条件の組み合わせ

and / or で条件式を連結できます。 例: log_name = "stdout" and http_latency_ns > 1000000

条件式は括弧でグループ化できます。 例: (span_status_code_text = "ERROR" or span_status_message ilike "%error%") and span_duration_unix_nano > 1000000

その他

数値は倍精度浮動小数点数(64-bit) として扱われるため、桁数の大きい値は正確に比較できない場合があります。

サポートされるAgent向けエンドポイント

Prometheus, fluent-bit, OpenTelemetry Collector等の各種エージェントからデータを送信するためのエンドポイントは以下の通りです。 [Resource ID] は各ストレージのリソースIDに置き換えてください。

メトリクスストレージ

  • Prometheus互換 HTTP API https://[Resource ID].metrics.monitoring.global.api.sacloud.jp/prometheus/

    • Query GET,POST /api/v1/query

    • Range Query GET,POST /api/v1/query_range

    • Series検索 GET,POST /api/v1/series

    • Labels GET,POST /api/v1/labels

    • Label Values GET /api/v1/label/<label_name>/values

    • Remote Write 1.0 POST /api/v1/write

ログストレージ

  • OpenTelemetry Protocol (OTLP/HTTP) https://[Resource ID].logs.monitoring.global.api.sacloud.jp/v1/logs

トレースストレージ

  • OpenTelemetry Protocol (OTLP/HTTP) https://[Resource ID].traces.monitoring.global.api.sacloud.jp/v1/traces

サポート

ご不明点やお困りの際は、 会員メニュー内のメールサポート より、サービス情報を「さくらのクラウド」としてお問い合わせください。

この際に、該当の機能名・コントロールパネルパネル上で表示されるリソースIDを連絡いただけますと、スムーズな対応が可能です。ご協力いただけますようお願いします。