Simple Log Service (SLS) は、さまざまな種類のサービスログを生成できるサービスログ機能を提供します。このトピックでは、さまざまなサービスログのタイプとそれぞれのフィールドについて説明します。
ログタイプ
サービスログ機能を有効にする場合は、生成するサービスログのタイプを選択する必要があります。次の表に、サービスログのタイプを示します。
カスタムクエリ文の互換性を確保するために、ログタイプを __topic__: XXX 形式で指定することを推奨します。
ログタイプ | 概要 | Logstore | ログ詳細 | 説明 |
詳細ログ | プロジェクト内のリソースに対して実行された操作 (作成、変更、削除、読み取り、書き込み操作など) を記録します。 説明 JDBC プロトコル経由で転送されたログは除外されます。 | internal-operation_log | SLS コンソール、コンシューマーグループ、SDK を使用して送信されたリクエストを含む、すべての API リクエストの詳細ログです。 | |
重要ログ | コンシューマーグループの消費遅延イベントと、Logstore ごとの Logtail のエラー、ハートビート、統計に関連するイベントを記録します。 | internal-diagnostic_log | コンシューマーグループの消費遅延ログです。これらのログは 2 分間隔で生成されます。コンシューマーグループの消費遅延ログをクエリする場合は、クエリ文に | |
Logtail のエラーを記録するアラートログです。 アラートログは 30 秒間隔で生成されます。同じエラーが 30 秒以内に複数回発生した場合、アラートログは 1 つだけ生成されます。アラートログには、エラーが発生した合計回数と 1 つのエラーメッセージが含まれます。Logtail アラートログをクエリする場合は、クエリ文に | ||||
Logtail 構成に関する統計を記録する収集ログです。 これらのログは 10 分間隔で生成されます。Logtail 収集ログをクエリする場合は、クエリ文に | ||||
Logtail のステータスログです。Logtail は定期的にステータスをレポートします。 これらのログは 1 分間隔で生成されます。Logtail ステータスログをクエリする場合は、クエリ文に | ||||
ジョブ操作ログ | 指定されたプロジェクトのデータ変換 (新バージョン) ジョブ、Scheduled SQL ジョブ、データインポートジョブ、データシッピング (新バージョン) ジョブの実行メトリックと操作を記録します。 | internal-diagnostic_log | Scheduled SQL インスタンスは、Scheduled SQL ログに対応します。Scheduled SQL インスタンスの実行が停止すると、ログがレポートされます。 Scheduled SQL 操作ログをクエリする場合は、クエリ文に | |
これらのログは 1 分間隔で生成されます。ジョブ関連のデータソースにデータがない場合、ログはレポートされません。 ジョブ操作ログをクエリする場合は、クエリ文に |
詳細ログ
詳細ログは、Method フィールドに基づいて、読み取り操作ログ、書き込み操作ログ、リソース操作ログのカテゴリに分類されます。次の表に、詳細ログのカテゴリを示します。
カテゴリ | リクエストメソッド |
読み取り操作ログ | 読み取り操作ログは、次の API 操作を呼び出すときに生成されます。
|
書き込み操作ログ | 書き込み操作ログは、次の API 操作を呼び出すときに生成されます。
|
リソース操作ログ | リソース操作ログは、次の API 操作を呼び出すときに生成されます。 CreateProject や DeleteProject などの API 操作 |
詳細ログの共通フィールド
フィールド | 説明 | 例 |
APIVersion | API のバージョンです。 | 0.6.0 |
AccessKeyId | SLS へのアクセスに使用される AccessKey ID です。 | LTA****TRx |
CallerType | API 呼び出し元のタイプです。 | Subuser |
InvokerUid | API 操作の呼び出しに使用される Alibaba Cloud アカウントの ID です。 | 175****532 |
Latency | リクエストのレイテンシです。単位:マイクロ秒。 | 123279 |
LogStore | Logstore の名前です。 | logstore-1 |
Method | ログが記録される API 操作です。 | GetLogStoreLogs |
NetOutFlow | 読み取りトラフィックの量です。単位:バイト。 | 120 |
NetworkOut | インターネット経由で受信した読み取りトラフィックの量です。単位:バイト。 | 10 |
Project | プロジェクトの名前です。 | project-1 |
RequestId | リクエストの ID です。 | 8AEADC8B0AF2FA2592C9**** |
SourceIP | リクエストを送信するクライアントの IP アドレスです。 | 47.100.**.** |
Status | リクエストへのレスポンスに含まれる HTTP ステータスコードです。 | 200 |
UserAgent | クライアントが API 操作の呼び出しに使用するエージェントです。 | sls-java-sdk-v-0.6.1 |
読み取り操作ログ固有のフィールド
フィールド | 説明 | 例 |
BeginTime | リクエストの開始時刻です。値は UNIX タイムスタンプです。 | 1523868463 |
DataStatus | リクエストへのレスポンスです。有効値には、Complete、OK、Unknown があります。 | OK |
EndTime | リクエストの終了時刻です。値は UNIX タイムスタンプです。 | 1523869363 |
Offset | GetLogs 操作を呼び出すときに指定する読み取りオフセットです。 | 20 |
Query | 元のクエリ文です。 | UserAgent: [consumer-group-java]* |
RequestLines | 呼び出し元によってリクエストされた行数です。 | 100 |
ResponseLines | 返された行数です。 | 100 |
Reverse | ログがタイムスタンプの降順で返されるかどうかを示します。
| 0 |
TermUnit | 検索文に含まれる区切りキーワードの数です。 | 0 |
Topic | ログの Topic です。 | topic-1 |
書き込み操作ログ固有のフィールド
フィールド | 説明 | 例 |
InFlow | 書き込む生データのサイズです。単位:バイト。 | 200 |
InputLines | 書き込む行数です。 | 10 |
NetInflow | 書き込む圧縮データのサイズです。単位:バイト。 | 100 |
Shard | データが書き込まれるシャードの ID です。 | 1 |
Topic | ログの Topic です。 | topic-1 |
コンシューマーグループの消費遅延ログ
フィールド | 説明 | 例 |
consumer_group | コンシューマーグループの名前です。 | consumer-group-1 |
fallbehind | 現在の消費チェックポイントと最後の書き込み操作ログが記録された時刻との間の間隔です。単位:秒。 | 12345 |
logstore | Logstore の名前です。 | logstore-1 |
project | プロジェクトの名前です。 | project-1 |
shard | データが消費されるシャードの ID です。 | 1 |
Logtail アラートログ
フィールド | 説明 | 例 |
alarm_count | 指定されたタイムウィンドウでアラートが生成された回数です。 | 10 |
alarm_message | アラートをトリガーしたサンプルの生ログです。 | M_INFO_COL,all_status_monitor,T22380,0,2018-04-17 10:48:25.0,AY66K,AM5,2018-04-17 10:48:25.0,2018-04-17 10:48:30.561,i-23xebl5ni.1569395.715455,901,00789b |
alarm_type | アラートのタイプです。 | REGISTER_INOTIFY_FAIL_ALARM |
logstore | Logstore の名前です。 | logstore-1 |
os | オペレーティングシステムです。例:Linux または Windows。 | Linux |
project | プロジェクトの名前です。 | project-1 |
source_ip | Logtail がインストールされているサーバーの IP アドレスです。 | 47.100.**.** |
version | Logtail のバージョンです。 | 0.14.2 |
Logtail 収集ログ
Logtail 収集ログは、file_name フィールドに基づいて、次の 2 つのサブタイプに分類されます。
ログファイルに対する Logtail 構成に関する統計。
Logstore に対する Logtail 構成に関する統計。この構成では、file_name フィールドは
logstore_statisticsに設定されます。
次の表に、Logtail 収集ログのフィールドを示します。
フィールド | 説明 | 例 |
logstore | Logstore の名前です。 | logstore-1 |
config_name | Logtail 構成の名前です。名前は次の形式である必要があります: | ##1.0##project-1$logstore-1 |
error_line | エラーの原因となった生ログです。 | M_INFO_COL,all_status_monitor,T22380,0,2018-04-17 10:48:25.0,AY66K,AM5,2018-04-17 10:48:25.0,2018-04-17 10:48:30.561,i-23xebl5ni.1569395.715455,901,00789b |
file_dev | ログファイルのデバイス ID です。 説明
| 123 |
file_inode | ログファイルの inode です。 説明
| 124 |
file_name | ログファイルの完全なパス、または | /abc/file_1 |
file_size | ログファイルのサイズです。単位:バイト。 | 12345 |
history_data_failures | データ処理に失敗した回数です。 | 0 |
last_read_time | 指定されたタイムウィンドウでの最終読み取り時刻です。値は UNIX タイムスタンプです。 | 1525346677 |
project | プロジェクトの名前です。 | project-1 |
logtail_version | Logtail のバージョンです。 | 0.14.2 |
os | オペレーティングシステムです。 | Windows |
parse_failures | 指定されたタイムウィンドウで解析に失敗した行数です。 | 12 |
read_avg_delay | 指定されたタイムウィンドウでログデータが読み取られるたびに生成される、実際のファイルサイズとオフセット値の差の平均です。 | 65 |
read_count | 指定されたタイムウィンドウでの読み取り回数です。 | 10 |
read_offset | ログファイルの最終読み取りオフセットです。単位:バイト。 | 12345 |
regex_match_failures | 正規表現のマッチングに失敗した回数です。 | 1 |
send_failures | 指定されたタイムウィンドウでログの送信に失敗した回数です。 | 12 |
source_ip | Logtail がインストールされているサーバーの IP アドレスです。 | 47.100.**.** |
succeed_lines | 処理された行数です。 | 123 |
time_format_failures | ログ時刻のマッチングに失敗した回数です。 | 122 |
total_bytes | 読み取られたデータの合計サイズです。単位:バイト。 | 12345 |
file_name フィールドが logstore_statistics に設定されている場合に収集される Logstore 統計に固有のフィールドを次の表に示します。
フィールド | 説明 | 例 |
send_block_flag | 指定されたタイムウィンドウが終了したときに送信キューがブロックされているかどうかを示します。 | false |
send_discard_error | 指定されたタイムウィンドウでデータエラーまたは権限不足のために破棄されたパケットの数です。 | 0 |
send_network_error | 指定されたタイムウィンドウでネットワークエラーのために送信に失敗したパケットの数です。 | 12 |
send_queue_size | 指定されたタイムウィンドウが終了したときに現在の送信キューにある未送信パケットの数です。 | 3 |
send_quota_error | 指定されたタイムウィンドウで Logtail クォータを超えたために送信に失敗したパケットの数です。 | 0 |
send_success_count | 指定されたタイムウィンドウで送信されたパケットの数です。 | 12345 |
sender_valid_flag | 指定されたタイムウィンドウが終了したときに現在の Logstore の送信フラグが有効かどうかを示します。有効値:
| true |
max_send_success_time | 指定されたタイムウィンドウでデータが最後に送信された時刻です。値は UNIX タイムスタンプです。 | 1525342763 |
max_unsend_time | 指定されたタイムウィンドウで送信キューのパケットが最後に送信に失敗した時刻です。値は UNIX タイムスタンプです。送信キューが空の場合、値は 0 です。 | 1525342764 |
min_unsend_time | 指定されたタイムウィンドウで送信キューのパケットが最初に送信に失敗した時刻です。値は UNIX タイムスタンプです。送信キューが空の場合、値は 0 です。 | 1525342764 |
Logtail ステータスログ
フィールド | 説明 | 例 |
cpu | Logtail プロセスの CPU 負荷です。 | 0.001333156 |
hostname | ホスト名です。 | abc2.**** |
instance_id | インスタンスの ID です。この ID はランダムに割り当てられます。 | 05AFE618-0701-11E8-A95B-00163E025256_10.11.12.13_151745**** |
ip | ホストの IP アドレスです。 | 47.100.**.** |
load | 平均システム負荷です。 | 0.01 0.04 0.05 2/376 5277 |
memory | Logtail プロセスが占有するメモリ領域です。単位:MB。 | 12 |
detail_metric | JSON 形式のメトリックです。詳細については、「detail_metric」をご参照ください。 | |
os | オペレーティングシステムです。 | Linux |
os_cpu | システムの CPU 使用率です。 | 0.004120005 |
os_detail | オペレーティングシステムの詳細です。 | 2.6.32-220.23.8.tcp1.34.el6.x86_64 |
user | ユーザー名です。 | user |
user_defined_id | ユーザー定義 ID です。 | aliyun-log-id |
uuid | サーバーの汎用一意識別子 (UUID) です。 | 64F28D10-D100-492C-8FDC-0C62907F**** |
version | Logtail のバージョンです。 | 0.14.2 |
project | Logtail 構成が属するプロジェクトです。 | my-project |
次の表に、detail_metric フィールドに含まれるフィールドを示します。
フィールド | 説明 | 例 |
config_count | Logtail 構成の数です。 | 1 |
config_get_last_time | Logtail 構成が最後に取得された時刻です。 | 2021-07-20 16:19:22 |
config_update_count | Logtail の起動後に Logtail 構成が更新された回数です。 | 1 |
config_update_item_count | Logtail の起動後に更新された設定項目の合計数です。 | 1 |
config_update_last_time | Logtail の起動後に Logtail 構成が最後に更新された時刻です。 | 2021-07-20 16:18:42 |
env_config | 環境変数を使用して Logtail 構成を作成するかどうかを示します。 | false |
event_tps | トランザクション/秒 (TPS) です。 | 1 |
last_read_event_time | データが最後に読み取られた時刻です。 | 2021-07-20 16:18:42 |
last_send_time | データが最後に送信された時刻です。 | 2021-07-20 16:18:42 |
multi_config | 同じファイルからログを収集するために複数の Logtail 構成が有効になっているかどうかを示します。 | false |
net_err_stat | 過去 1、5、15 分間に発生したネットワーク送信エラーの回数です。 | 0,0,0 |
open_fd | 開いているログファイルの数です。 | 1 |
plugin_enabled | Logtail プラグインが有効かどうかを示します。
| false |
poll_modify_size | 変更された監視対象ログファイルの数です。 | 1 |
polling_dir_cache | スキャンされたディレクトリの数です。 | 1 |
polling_file_cache | スキャンされたファイルの数です。 | 1 |
process_bytes_ps | 1 秒あたりに処理されるログデータのサイズです。単位:バイト。 | 1000 |
process_lines_ps | 1 秒あたりに処理されるログの数です。 | 1000 |
process_queue_full | 最大処理能力に達した処理キューの数です。 | 1 |
process_queue_total | 処理キューの合計数です。 | 10 |
process_tps | 1 秒あたりのデータ処理トランザクション数です。 | 0 |
reader_count | 処理中のログファイルの数です。 | 1 |
region | Logtail が存在するリージョンです。 | cn-hangzhou |
register_handler | 監視対象のディレクトリ数です。 | 1 |
send_bytes_ps | 1 秒あたりに送信される生ログデータのサイズです。単位:バイト。 | 11111 |
send_lines_ps | 1 秒あたりに送信されるログの数です。 | 1000 |
send_net_bytes_ps | 1 秒あたりに送信されるネットワークデータの量です。単位:バイト。 | 1000 |
send_queue_full | 最大送信能力に達した送信キューの数です。 | 1 |
send_queue_total | 送信キューの合計数です。 | 12 |
send_request_concurrency | 送信キューから同時に送信できるパケットの最大数です。 | 10 |
send_tps | 1 秒あたりのデータ送信トランザクション数です。 | 0.075 |
sender_invalid | 異常な送信キューの数です。 | 0 |
start_time | 開始時刻です。 | 2021-07-20 16:19:22 |
used_sending_concurrency | 同時に送信されるパケットの数です。 | 0 |
Scheduled SQL ジョブの操作ログ
フィールド | 説明 | 例 |
__topic__ | ログの Topic です。有効値:scheduled_sql_alert。 | scheduled_sql_alert |
project | Scheduled SQL ジョブが属するプロジェクトです。 | my-project-name |
job_name | Scheduled SQL ジョブの名前です。 | sql-16xxxxxxx-xxxxxx |
schedule_id | Schedule SQL ジョブの ID です。 | 77****ca |
job_type | Scheduled SQL ジョブのタイプです。有効値:ScheduledSQL。 | ScheduledSQL |
instance_id | Scheduled SQL ジョブのインスタンスの ID です。 | 7e****dc |
create_time | インスタンスが作成された時刻です。単位:秒。 | 1652343365 |
schedule_time | インスタンスのスケジュールされた時刻です。単位:秒。 | 1652343360 |
trigger_time | インスタンスの実行が開始される時刻です。単位:秒。 | 1652343365 |
__time__ | インスタンスの実行が停止する時刻です。単位:秒。 | 1652343366 |
status | インスタンスのステータスです。有効値:FAILED、SUCCEEDED。 | FAILED |
error_code | インスタンスの実行に失敗した原因です。 | SQLFailed |
error_message | インスタンスの実行に失敗したエラーの詳細です。 | sql syntax error |
fallbehind | インスタンスの開始時刻とスケジュールされた時刻の間の間隔です。このフィールドはインスタンスのレイテンシを示します。単位:秒。 | 85 |
succeed_lines |
| 100 |
データ変換 (新バージョン) ジョブ、データインポートジョブ、データシッピング (新バージョン) ジョブの操作ログ
フィールド | 説明 | 例 |
__topic__ | ログの Topic です。有効値:etl_metrics。 | etl_metrics |
metric_type | ジョブ操作ログのタイプです。有効値:ConnectorMetrics。 | ConnectorMetrics |
project | ジョブが属するプロジェクトです。 | my-sls-project |
job_name | ジョブの名前です。 | job-16****53 |
instance_id | ジョブのインスタンスの ID です。 | 10e****b4f6 |
_etl_:connector_meta | データソースまたは宛先のタスクメタデータです。詳細については、「_etl_:connector_meta」をご参照ください。 | なし |
_etl_:connector_metrics | データソースまたは宛先のタスク実行メトリックです。詳細については、「_etl_:connector_metrics」をご参照ください。 | なし |
次の表に、_etl_:connector_meta フィールドに含まれるサブフィールドを示します。
フィールド | 説明 | 例 |
action | タスクによって実行される操作です。有効値:
| ingest |
connector | データソースまたは宛先のタイプです。
| oss |
instance | データソースインスタンスまたは宛先インスタンスの名前です。 | my-oss-bucket |
task_id | タスクの ID です。 | 1669277 |
task_name | タスクの名前です。 | 1652765276578_task_0 |
task_type | タスクのタイプです。有効値:CONNECTOR。 | CONNECTOR |
次の表に、_etl_:connector_metrics フィールドに含まれるサブフィールドを示します。
フィールド | 説明 | 例 |
state | タスクのステータスです。
| 0 |
error | タスクのエラーメッセージです。 エラーメッセージが存在しない場合、このフィールドはログに表示されません。 | fail to pull logs, unauthorized |
lags | タスクの進行状況です。 このフィールドは、データを読み取るために使用されるタスクでのみ使用できます。lags フィールドは、action フィールドの値が ingest の場合にのみログに表示されます。このフィールドの値は、connector フィールドで指定されたデータソースのタイプによって異なります。
| 0.813 |
desc | このフィールドは、データを読み取るために使用されるタスクでのみ使用できます。desc フィールドは、action フィールドの値が ingest の場合にのみログに表示されます。このフィールドの値は、connector フィールドで指定されたデータソースのタイプによって異なります。
| s |
events | 指定された時間範囲内に処理されたデータエントリの数です。 | 13245 |
failed | 指定された時間範囲内に処理に失敗したデータエントリの数です。 | 3 |
native_bytes | 指定された時間範囲内に処理された生データのサイズです。 | 7539125 |
events_bytes | 指定された時間範囲内に処理された解析済みデータのサイズです。 | 13295475 |
pub_net_bytes | 指定された時間範囲内にインターネット経由で処理されたトラフィックの量です。 | 45678 |
req_count | 指定された時間範囲内にデータソースまたは宛先に送信されたリクエストの数です。 | 89 |
rep_time | 指定された時間範囲内のデータソースまたは宛先の平均リクエストレイテンシです。 | 38 |
rate_limit_hits | 指定された時間範囲内にデータソースまたは宛先に送信されたリクエストがスロットルされた回数です。 | 1 |
extras | その他の関連情報です。このフィールドは、フィールドの値が存在する場合にのみログに表示されます。 このフィールドの値は、connector フィールドで指定されたデータソースのタイプによって異なります。 | {"events":"898","objectName":"shenzhen/2022/05/18/15/19_1652858350000000000_315eb857efeb9f00.snappy","objectSize":"212792"} |