ログの表示

このガイドでは、ログビューアでログの検索とログエントリの表示を行う方法を説明します。ログエントリをエクスポートする方法については、ログのエクスポートをご覧ください。Stackdriver Logging API を使用してログエントリを読み取る方法については、entries.list をご覧ください。Google Cloud SDK を使用してログエントリを読み取る方法については、ログエントリを読み取るをご覧ください。

始めに

GCP Console で [Stackdriver] > [ロギング] ページの順に移動します。

ログビューアページに移動
ページの先頭にある既存の GCP プロジェクトを選択するか、新しいプロジェクトを作成します。
プルダウンメニューを使用して、ログを表示するリソースを選択します。

ログが表示されない場合は、以下のトラブルシューティングをご覧ください。

ワークスペースとロギング

Amazon Web Services（AWS）からログを送信する機能が必要でない限り、Stackdriver Logging を使用するためにワークスペースは必要ありません。

Stackdriver Monitoring とワークスペースを使用する場合、Stackdriver Logging はモニタリング対象プロジェクトのログをアカウントプロジェクトに統合しません。表示するログが属するプロジェクトを選択する必要があります。Amazon Web Services アカウントで生成されたログの場合、AWS ログを表示するには AWS コネクタプロジェクトを選択する必要があります。

ログビューアのフィルタインターフェース

ログビューアには、2 つのフィルタリングインターフェースがあります。

デフォルトの基本フィルタインターフェースでは、メニューからログを選択でき、簡単な検索機能があります。
高度なフィルタインターフェースでは、基本フィルタインターフェースのメニューよりも強力な検索機能を使用でき、複数のログからログエントリを表示できます。

インターフェースを切り替えるには、インターフェースの検索フィルタボックスの右側にある ▾ メニューを使用します。次のスクリーンショットは、ログビューアのレイアウトを示しています。Compute Engine VM インスタンスの 4 つのログエントリが表示されています。展開矢印（▸）がクリックされ、2 番目のエントリが展開されています。

ログビューア

上のスクリーンショットに赤い数字で示されている、基本フィルタインターフェースの主な構成要素は次のとおりです。一部の要素は高度なフィルタインターフェースにも表示されます。

ウィンドウタブでは、[ログ]、[指標]（ログベースの指標を参照）、[エクスポート]（ログのエクスポートを参照）、[ログの取り込み] を選択できます。
基本フィルタインターフェースの検索フィルタボックスでは、ラベルまたはテキスト検索を使用してログエントリをフィルタリングできます。基本フィルタが表示されますが、端のメニュー（▾）を使用すると、高度なフィルタインターフェースに切り替えられます。
基本セレクタメニューでは、表示するリソース、ログ、重大度レベルを選択できます。
期間セレクタのプルダウンメニューでは、特定の日時でログをフィルタリングできます。
ページの先頭にあるストリーミングセレクタでは、新しいログエントリを受信時に表示するかどうかを制御できます。
ログエントリテーブルには、現在のフィルタとカスタムフィールドに応じて使用可能なログエントリが含まれています。
各ログエントリの前にある展開矢印（▸）を使用すると、エントリの全内容を見ることができます。詳しくは、ログエントリの展開をご覧ください。
[表示設定] メニュー: 右端にあり、その他の表示オプションがあります。

ログのスクロールとストリーミング

最初にログビューアを開いた時点では、最新のログエントリから順に表示されます。ログエントリをスクロールすると、ログビューアに追加のエントリが表示されます。ログの上下に表示される黄色いバーを使用すると、他のログエントリが使用可能かどうかを確認できます。[表示設定] メニューを使用すると、ログエントリの表示順を選択できます。

画面の先頭にあるアイコンを使用して、ログを更新します。

[更新] アイコン（最新のログに移動）を使用して、最新のログを取得し、画面をスクロールします。
[再生] アイコン（▶）を使用して、最新ログのストリーミングを開始します。停止するには、ログエントリを選択するか、ログ画面をスクロールします。
[一時停止] アイコン（▐▐）を使用して、最新ログのストリーミングを停止します。

時間までスクロール

検索フィルタボックスの下にある期間セレクタメニューを使用すると、ログエントリを時間と日付でフィルタリングできます。

期間セレクタ

デフォルトの選択は過去 1 時間です。プルダウンメニューから他の期間を選択したり、カスタム範囲を定義したりできます。特定の日時のログをフィルタリングするには、[時間を選択] を選択します。現在のログエントリを表示するには、[現在に移動] メニューを使用します。選択したら、ログをスクロールして、その時間のエントリを調べることができます。ページの先頭にある [更新] または [再生] アイコンをクリックすると、メニューの日時をリセットして、最後に受信したログエントリに移動できます。

タイムゾーンを変更する

ログをフィルタリングするタイムゾーンを選択できます。

前述のプルダウンメニューのスクリーンショットに示すように、[過去 1 時間] の下の [カスタム] を選択します。[カスタム] の右側に 2 つの新しいメニューが表示されます。
新しいメニューの 1 つで展開矢印（▾）をクリックします。カレンダーのメニューが表示されます。
カレンダーのメニューの [タイムゾーン] セクションで、該当する国とタイムゾーンを選択します。
ログビューアに、更新されたタイムゾーンの設定が表示されます。

ログエントリの展開

ログエントリテーブルには、デフォルトで、各ログエントリの概要行が表示されます。以下のスクリーンショットでは、概要行の 1 つを赤色で示しています。

ログビューアでは、概要行のログエントリの特定のフィールドが強調表示されます。特定のフィールドは、次の基準を満たす場合にデフォルトで表示されます。

ログエントリに、よく知られているタイプ（たとえば、App Engine リクエストログなど）が含まれている。
または、ログエントリに httpRequest フィールドが含まれている。
または、ログエントリに、message という名前のフィールドを含むペイロードがある。

概要行に他のフィールドを追加することもできます。詳細については、カスタムフィールドの追加をご覧ください。

1 つのログエントリの詳細を表示するには、概要行の前にある展開矢印（▸）をクリックします。現在のフィルタで表示されるすべてのログエントリについて、構造化ビューで詳細を表示するには、右端の [表示設定] メニューをクリックし、[すべてを展開] を選択します。

[折りたたむ] を選択すると、展開されたログエントリの詳細を折りたたむことができます。

ログエントリの概要行を展開すると、そのログエントリの構造化（JSON）ビューが表示されます。

エントリフィールドの詳細については、LogEntry をご覧ください。

カスタムフィールドの追加

カスタムフィールドは、メインのログエントリ概要の概要行に追加できる、ログエントリ内のフィールドです。

ログエントリテーブルの概要行にカスタムフィールドを追加するには、2 つの方法があります。

展開されたログエントリで、JSON 表現内のフィールドをクリックします。結果のパネルで、[概要行にフィールドを追加] を選択します。

ログビューアの右上隅にある [表示設定] メニューから [カスタムフィールドの追加] を選択します（このプロジェクトにすでにカスタムフィールドがある場合、このオプションは [カスタムフィールドを変更] になります）。結果のパネルで、目的の JSON キーを追加して [保存] をクリックします。複数のキーを追加する場合は、これらのキーをカンマで区切ります。概要行のカスタムフィールドの表示順序を変更するには、このパネルのテキストの順序を変更し、[保存] をクリックします。

カスタムフィールドは、ログエントリに表示される場合は常に入力されます。カスタムフィールドは、現在の URL に追加され、その URL を使用しているか、同じブラウザセッション内にいる限り、そのまま残ります。これらは、グローバルに設定することはできず、ユーザーごとに保存することも、GCP プロジェクトごとに保存することもできません。

カスタムフィールドは、ログエントリテーブルで青色で強調表示されます。

ログエントリテーブルの概要行からカスタムフィールドを削除するには、2 つの方法があります。

削除するカスタムフィールドがある概要行から、そのフィールドをクリックして、[概要行からフィールドを削除] を選択します。
ログビューアの右上隅にある [表示設定] メニューから [カスタムフィールドを変更] を選択します。結果のパネルで、削除する JSON キーを削除して [保存] をクリックします。

デフォルトのフィールドはログエントリテーブルから削除できません。

類似したログを表示する

展開されたログエントリビューの個別のフィールドの値をクリックしてから、同じ値のすべてのログエントリを表示または非表示にできます。

一致エントリを表示

この操作を行うと、ログビューアが高度なフィルタインターフェースに切り替わります。検索条件を変更するには、フィルタを編集して [フィルタを送信] をクリックします。詳細については、高度なフィルタインターフェースをご覧ください。

また、App Engine リクエストログエントリを関連付けて、ネスト構造で表示することもできます。詳しくは、関連付けられたリクエストログエントリの表示をご覧のうえ、ランタイム言語を選択してください。

ログを選択する

メニューとフィルタボックスを使用して、必要なログを検索します。

必要なログのリソースタイプとインスタンスを選択します。リソースタイプのすべてのインスタンスを表示することも、特定のインスタンスを選択することもできます。上のスクリーンショットでは、[GCE VM インスタンス]（すべてのインスタンス）が選択されています。リソースタイプの一覧については、モニタリング対象リソースのリストをご覧ください。
2 番目のメニューから必要なログ名を選択するか、[すべてのログ] を選択します。メニューには、選択したリソースインスタンス別に使用中のログが表示されます。
3 番目のメニューで、最も低い重大度レベルを選択します。[すべて] を選択すると、重大度が割り当てられていないログエントリも表示されます。
4 番目のメニューから期間を選択するか、5 番目のメニューから [現在に移動] を選択します。

メニューの選択を変更すると、条件に一致するログエントリが表示されます。

メニューに関する注意事項:

メニューに表示されるのは、プロジェクト内に存在するリソースタイプ、インスタンス、ログ名だけです。新しいリソースタイプやインスタンスを追加した後、あるいは新しいログを書き込んだ後にメニューが更新されるまで、少し時間がかかる場合があります。
基本フィルタインターフェースでは、1 つのリソースタイプのログエントリしか表示されません。高度なフィルタインターフェースでは、複数のリソースタイプを同時に表示できます。
現在の保存期間より前の時間を選択した場合、ログは表示されません。詳しくは、ログの保存期間をご覧ください。

ログビューアによる検索

基本フィルタインターフェースでも高度なフィルタインターフェースでも、フィルタを使用して検索範囲を絞り込むことができます。高度なフィルタインターフェースでは、基本フィルタインターフェースで実行できる機能に加え、より強力な検索機能を使用できます。

基本フィルタインターフェースで検索する方法の詳細については、基本ログフィルタをご覧ください。高度な検索の詳細については、高度なログフィルタをご覧ください。

基本フィルタと高度なフィルタの違い

基本フィルタインターフェースのテキスト検索とフィールド検索の使い方に慣れたら、高度なログフィルタとの違いに注意しましょう。

text: を使用しない

ログビューアの基本フィルタによるテキスト検索では、テキストの先頭に text: というラベルが付加されます。高度なフィルタでは text: ラベルを使用しないでください。次の表は、同じ意味を持つテキスト検索を表しています。

ログビューアの基本フィルタ	同じ意味を持つ高度なログフィルタ
`text:"one two"`	`"one two"`
`text:three`	`three`
`text:n=5`	`"n=5"` （引用符が必要）

高度なフィルタで誤って text: を使用した場合、text というフィールドで一致が検索されることになりますが、このフィールドは存在しません。

フィールド名を確認する

基本フィルタインターフェースには、App Engine リクエストログを含む特定のログのフィールド名が組み込まれています。これらのフィールド名は、高度なフィルタには存在しません。たとえば、次の表は、App Engine リクエストログに対して同等なフィールド検索を表しています。

基本フィルタ	高度なフィルタ
`querystring:var=3`	`protoPayload.resource:"var=3"`
`status:400..405`	`protoPayload.status >= 400 AND protoPayload.status <= 405`

最初のサンプルで、誤って基本フィルタのフィールド名を使用した場合、querystring という名前のフィールドを検索することになりますが、このフィールドは存在しないため、ログビューアでログは検索されません。

部分文字列の一致

基本フィルタインターフェースでは、すべての検索が部分一致で、大文字と小文字が区別されません。text:abc または somefieldname:abc を検索すると、abc、xyabcyx、ABc を含むログエントリが表示されます。高度なログフィルタの場合、同じ結果を表示するには "has" 検索演算子（:）を使用する必要があります。

完全に一致させるには、等価演算子（=）を使用します。比較 field=abc では、大文字小文字を含めて field に abc が正確に含まれている必要があります。この検索条件は、基本フィルタインターフェースで指定できません。

AND と OR

基本フィルタインターフェースでは、フィールド名が同じ（または text:）である 2 つの比較は暗黙に OR で結合されます。これに対して、ラベルが異なる比較は AND で結合されます。高度なログフィルタでは、OR を明示的に指定しない限り、すべての比較が AND で結合されます。括弧を使用して比較をグループ化することもできます。次の表は、2 つのフィルタインターフェースによる同等の検索を示しています。

基本フィルタでの検索	高度なフィルタでの検索
`text:abc querystring:def text:xyz`	`protoPayload.resource:"def" AND ("abc" OR "xyz")`

検索のパフォーマンス

検索のパフォーマンスを改善するヒントをいくつか紹介します。

インデックス付きフィールドの特定の値を検索する。たとえば、ログエントリの名前、リソースタイプ、リソースラベルなどを検索します。基本フィルタインターフェースでは、これらの項目をメニューから選択できます。高度なフィルタインターフェースでは、次のような条件を指定します。
```
resource.type = "gce_instance"
logName = "project/[PROJECT_ID]/logs/cloudaudit.googleapis.com%2Factivity"
resource.labels.module_id="default"
resource.labels.instance_id="1234567890"
```
部分一致ではなく完全一致を選択する。特に、インデックス付きフィールドの場合、部分検索は時間がかかります。基本フィルタインターフェースでは、すべてのテキスト検索が部分一致です。高度なフィルタインターフェースでは、"has"（:）ではなく、等価演算子（=）を使用します。
検索期間を短くする。基本フィルタインターフェースでは、この操作はできません。高度なフィルタインターフェースでは、時間の範囲を指定できます。
```
timestamp >= "2016-11-29T23:00:00Z" AND timestamp <= "2016-11-29T23:30:00Z"
```

パフォーマンスの詳細については、ログエントリの迅速な検索をご覧ください。

トラブルシューティング

このセクションでは、ログビューアの操作または検索に関連する一般的な問題のトラブルシューティングについて説明します。

ログが表示されない場合

ログが表示されない場合には、次のことを確認してください。

正しいプロジェクトがページの上部で選択されているかどうか。 選択されていない場合は、ページの上部にあるプルダウンメニューを使用してプロジェクトを選択します。表示するログが属するプロジェクトを選択する必要があります。
プロジェクトにアクティビティがあるかどうか。 プロジェクトが新規の場合でも、作成されたという事実を記録した活動ログまたは監査ログがあります。クイックスタートを使用すると、より多くのログを取得できます。
時間範囲が狭すぎるかどうか。 検索フィルタボックスの下にあるプルダウンメニューを使用して、他の期間を選択したり、カスタム範囲を定義したりできます。特定の日時のログをフィルタリングするには、[時間を選択] を選択します。現在のログエントリを表示するには、[現在に移動] メニューを使用します。

検索できない場合

基本フィルタインターフェースで検索できない理由がわからない場合は、一時的に高度なフィルタインターフェースに切り替えます。

検索ボックスの最後にある ▾ メニューで、[高度なフィルタに変換] を選択します。
高度なフィルタに目的のフィルタがあるか確認します。
ブラウザの [戻る] ボタンを使用して、基本フィルタインターフェースに戻ります。

必要なログエントリがすべて表示されない理由は他にもいくつかあります。

Stackdriver Logging の保持期間を超過したログエントリは表示されません。有効なログ保持期間については、割り当てポリシーをご覧ください。
負荷が高くなっている場合、Stackdriver Logging へのログの送信やログの受信と表示に遅延が生じることがあります。
タイムスタンプを持つログエントリは、現在の時刻がタイムスタンプに「追いつく」までログビューアに表示されません。これは異常な状況です。おそらく、ログを送信しているアプリケーションの時間のずれが原因です。

次のステップ

Google Cloud Storage、Google BigQuery、または Google Cloud Pub/Sub にログエントリをエクスポートする。
Stackdriver Monitoring のログベースの指標を作成する。
API を使用してログエントリを読み取る。
SDK を使用してログエントリを読み取る。

始めに