Simple Log Service はログ機能を備えています。この機能を利用することで、さまざまなログを生成できます。このトピックでは、ログの種類、およびログに関連するフィールドについて説明します。
ログの種類
ログ機能を有効化する際、生成するログの種類を選択する必要があります。下表にログの種類を示します。
カスタムクエリ文との互換性を確保するためには、ログタイプを __topic__: XXX
形式で指定することを推奨します。
ログタイプ | 概要 | LogStore | ログ詳細 | 説明 |
詳細ログ | プロジェクト内のリソースに対して行う操作 (作成、変更、削除、読み取り、書き込みなど) を記録します。 説明 JDBC プロトコルを介して転送されるログは除外されます。 | internal-operation_log | Simple Log Service コンソールで送信されたリクエストや、コンシューマーグループ、SDKを使用して送信されるリクエストなど、すべての API リクエストに関する詳細なログ。 | |
重要ログ | Logstore ごとのコンシューマグループの消費遅延イベント、Logtail のエラー、ハートビート、統計に関するイベントを記録します。 | internal-diagnostic_log | コンシューマーグループの消費遅延ログ。これらのログは 2 分ごどに生成されます。コンシューマーグループの消費遅延ログをクエリするには、クエリ文に | |
Logtail のエラーを記録するアラートログ。 アラートログは 30 秒ごとに生成されます。同じエラーが 30 秒以内に複数回発生した場合、アラートログは 1 つだけ生成されます。アラートログには、エラーが発生した合計回数と 1 つのエラーメッセージが記録されます。Logtail アラートログをクエリするには、クエリ文に | ||||
Logtail 設定に関する統計を記録する収集ログ。 これらのログは 10 分ごとに生成されます。Logtail 収集ログをクエリするには、クエリ文に | ||||
Logtail のステータスログ。Logtail は定期的にステータスを報告します。 これらのログは 1 分ごとに生成されます。Logtail ステータスログをクエリするには、クエリステートメントで | ||||
ジョブ実行ログ | 指定したプロジェクトのデータ変換 (新バージョン) ジョブ、スケジュールされた SQL ジョブ、データインポートジョブ、およびデータ転送 (新バージョン) ジョブを実行するメトリクスと操作を記録します。 | internal-diagnostic_log | スケジュールされた SQL インスタンスと スケジュールされた SQLログは一対一の関係です。すなわち、1 つのスケジュールされた SQL インスタンスが実行中に停止すると、1 つのログが報告されます。 スケジュールされた SQL 実行ログをクエリする際、クエリ文に | |
これらのログは 1 分ごとに生成されます。ジョブ関連のデータソースにデータがない場合、ログは報告されません。 ジョブ実行ログをクエリする際、クエリ文に |
詳細ログ
詳細ログは、Method フィールドに基づいて、読み取り操作ログ、書き込み操作ログ、およびリソース操作ログに分類されます。 詳細ログのカテゴリは下記の表に示されています。
カテゴリ | リクエストメソッド |
読み取り操作ログ | 読み取り操作ログは、下記の API を呼び出すと生成されます。
|
書き込み操作ログ | 書き込み操作ログは、下記の API を呼び出すと生成されます。
|
リソース操作ログ | リソース操作ログは、下記の API を呼び出すと生成されます。 CreateProject や DeleteProject などの API。 |
詳細ログの共通フィールド
フィールド | 説明 | 例 |
APIVersion | API のバージョン。 | 0.6.0 |
AccessKeyId | Simple Log Service にアクセスするために使用される 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-1 |
書き込み操作ログに固有のフィールド
フィールド | 説明 | 例 |
InFlow | 書き込む生データのサイズ。単位:バイト。 | 200 |
InputLines | 書き込む行数。 | 10 |
NetInflow | 書き込む圧縮データのサイズ。単位:バイト。 | 100 |
Shard | データが書き込まれる シャード ID。 | 1 |
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 収集ログ
Logtaill 収集ログは、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 | 1秒あたりのトランザクション数 (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 |
スケジュールされた SQL ジョブの操作ログ
フィールド | 説明 | 例 |
__topic__ | ログのトピック。有効値:scheduled_sql_alert 。 | scheduled_sql_alert |
project | スケジュールされた SQL ジョブが属するプロジェクト。 | my-project-name |
job_name | スケジュールされた SQL ジョブの名前。 | sql-16xxxxxxx-xxxxxx |
schedule_id | スケジュールされた SQL ジョブの ID。 | 77****ca |
job_type | スケジュールされた SQL ジョブのタイプ。有効値:ScheduledSQL。 | ScheduledSQL |
instance_id | スケジュールされた SQL ジョブのインスタンスの ID。 | 7e****dc |
create_time | インスタンスが作成された日付と時刻。単位:秒。 | 1652343365 |
schedule_time | インスタンスのスケジュールされた日付と時刻。単位:秒。 | 1652343360 |
trigger_time | インスタンスの実行が始まった日付と時刻。単位:秒。 | 1652343365 |
status | インスタンスのステータス。有効値:FAILED および SUCCEEDED。 | FAILED |
error_code | インスタンスの実行に失敗した原因。 | SQLFailed |
error_message | インスタンスの実行に失敗したエラーの詳細。 | sql syntax error |
fallbehind | インスタンスの実行開始時刻とスケジュールされた時刻の差。このフィールドは、インスタンスのレイテンシを示します。単位:秒。 | 85 |
succeed_lines |
| 100 |
データ変換 (新バージョン) ジョブ、データインポートジョブ、データ転送 (新バージョン) ジョブの操作ログ
フィールド | 説明 | 例 |
__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」をご参照ください。 | None |
_etl_:connector_metrics | データソースまたは保存先におけるタスク実行状況を評価するメトリクス。詳細については、「_etl_:connector_metrics」をご参照ください。 | None |
下表に、_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 |
req_count | 指定された期間内におけるデータソースまたは保存先の平均リクエストレイテンシ。 | 38 |
rate_limit_hits | データソースまたは保存先に送信されたリクエストが、指定された期間内でスロットリングにより制限された回数。 | 1 |
extras | その他の関連情報。このフィールドは、フィールドの値が存在する場合にのみログに表示されます。 このフィールドの値は、connector フィールドで指定されたデータソースのタイプによって異なります。 | {"events":"898","objectName":"shenzhen/2022/05/18/15/19_1652858350000000000_315eb857efeb9f00.snappy","objectSize":"212792"} |