UIでの検索
スコープ・フィルタの使用
有効範囲フィルタは、ログ・アナリティクス・コンソールでグローバル・コンテキストを設定し、それをログ・エクスプローラとダッシュボードの間で維持する機能を提供します。グローバル・コンテキストは、エンティティ・ログ・グループ、ログ・セットなどのログ・分析リソースに設定できます。
-
ログ・エクスプロラの左上隅にあるログ・アナリティクスの「フィルタ」
アイコンをクリックするか、「ダッシュボード詳細」ページで「スコープ・フィルタ」ダイアログ・ボックスを開きます。次のリソースの上位レベル・コンテキストを選択します:
-
リージョン: 検索するログ・データを使用できるテナンシ内のリージョンを選択します。リージョンの選択に基づいて、他のフィルタのオプションが調整されます。
複数のリージョンを選択した場合、スコープ・フィルタのコンテキストを含む保存済検索では、複数のリージョンも選択されます。結果のビジュアライゼーションでは、暗黙的な複数リージョン・グループ基準フィールドが追加されます。ビジュアライゼーションがすでにサポートされている最大グループ別フィールドにある場合、リージョンはいずれかのグループ別フィールドに連結されます。たとえば、円グラフでは、1つのグループ化フィールドのみがサポートされます。
複数のリージョンが選択されている場合、チャートのドリルダウン、エクスポート、サイドバーのフィルタリングなどの一部の機能はサポートされていません。結果は、エクスポートするかわりに「アクション」メニューを使用してダウンロードできます。
-
ログ・グループ: デフォルトでは、ルート・コンパートメントが選択され、サブコンパートメントを含めるオプションが有効になっています。この選択では、ルート・コンパートメントおよび階層内のサブコンパートメントのログ・グループが検索対象として選択されます。このスコープを変更して、「ログ・グループ・コンパートメント」のログ・グループに検索を絞り込むことができます。「サブコンパートメントを含む」を有効にすると、選択したコンパートメントのサブコンパートメントを横断してログが検索されます。
ノート
ログ・グループのコンパートメントを選択しても、検索対象のリソースが見つからない場合は、そのコンパートメントに対するユーザー・アクセス権があることを確認してください。 -
エンティティ: ログを検索するエンティティの名前を入力します。
「依存エンティティ」チェック・ボックスは、ログを検索するためにスコープ内に含めるように自動的に有効になります。これは、コンポジット・エンティティが「エンティティ」フィールドに指定されている場合に特に役立ちます。必要に応じて、このチェック・ボックスを無効にできます。
-
ログ・セット: テナンシでログ・パーティション化が有効になっている場合は、1つ、複数またはすべてのログ・セットを選択できます。
-
「適用」をクリックして、変更したログ問合せの結果をログ・エクスプローラに表示します。
-
オプションで、スコープ・フィルタでフィルタとして使用するフィールドを選択できます。
ログ・エクスプローラで「フィールド」パネルから、フィールドの横にある「アクション」メニュー
をクリックし、「スコープ・フィルタに追加」を選択します。これで、「スコープ・フィルタ」ダイアログにフィールドがフィルタとして表示されます。
スコープ・フィルタが適用されると、適用可能なフィルタが、ピルの形式で「フィルタ」アイコンの横に表示されます。スコープ・フィルタを変更するには、ピルをクリックします。ピルの(x)をクリックすると、そのフィルタは削除されます。
次に、スコープ・フィルタのグローバル・コンテキストのプロパティの一部を示します:
-
スコープ・フィルタと時間範囲の選択および変更は、ログ・エクスプローラとダッシュボードの間で引き継がれます。
-
保存済検索を使用してスコープ・フィルタと時間の選択を保存し、必要に応じて後で再利用できます。
エンティティでのログの検索
Oracle Logging Analyticsの「固定」セクションの「エンティティ」フィールドを使用して、1つまたは複数のエンティティでログをフィルタできます。
「フィルタ」オプションの使用
レコードの表を生成するビジュアライゼーションのフィルタ・オプションを使用して、ログ・レコードで使用可能なフィールドでログ・データをフィルタできます。
レコードの表を提供するビジュアライゼーションで、フィールド値をクリックしてフィルタ除外オプションを表示します。次の例で、ヒストグラム付きレコード・チャートには、エンティティ、エンティティ・タイプ、ログ・ソース、ホスト名などのフィールドに使用可能な値を含むレコードの表があります。
フィールド値をクリックすると、次のフィルタ オプションを使用できます。
- 検索に追加: クリックしたフィールドは検索問合せに追加され、ログ・データがフィルタされて、対応するフィールドが検索に含まれます。たとえば、エンティティ・タイプ値の
Host (Linux)をクリックして検索に追加すると、前の検索問合せが更新され、検索文字列に'Entity Type'='Host (Linux)'が含まれます。 - 検索から除外: フィールドは検索から除外され、指定したフィールド値を含まないログ・レコードの絞り込まれた結果が生成されます。たとえば、ログ・ソース値の
Linux Syslog Logsをクリックして検索から除外するように指定すると、前の検索問合せが更新され、検索文字列に'Log Source'!='Linux Syslog Logs'が含まれます。結果のログ・データには、指定したログ・ソースから収集されていないログ・レコードのみが含まれます。
固定された属性およびフィールドによるログのフィルタ
ソースおよびログ・メッセージのフィールドを使用してデータをフィルタすることもできます。
-
「固定」の属性では、次に基づいてログ・データをフィルタできます:
-
ソース(データベース・ログやOracle WebLogic Serverログなど)。
-
ログ・エンティティ(実際のログ・ファイル名)。
-
ラベル(ログ・エントリが特定の定義済条件と一致するときにログ・エントリに追加されるタグ)。ソースでのラベルの使用を参照してください。
-
オンデマンドでアップロードされたログ・データのアップロード名。オンデマンドでのログのアップロードを参照してください。
デフォルトでは、エンティティおよび収集の詳細は、フィルタ用として「フィールド」パネルの「固定」バケットで使用できます。使用状況に応じて、「固定」バケットに追加フィールドを固定できます。固定されると、フィールドは「固定」バケットに移動されます。フィールドの固定を解除し、固定バケットから削除して、「計算済」または「その他」バケットに戻すことができます。
-
-
検索および問合せに基づいて、Oracle Logging Analyticsでは、迅速に参照できるようにフィールドが「計算済」バケットに自動的に追加されます。「計算済」バケットの使用可能なフィールドを固定できます。固定されたフィールドは、「固定」バケットに移動されます。
-
「その他」バケットの任意のフィールドを固定して、「固定」バケットに移動できます。検索または問合せで「その他」バケットのフィールドを使用すると、「計算済」バケットに移動されます。
ソース属性でログをフィルタ
Oracle Logging Analyticsの「フィールド」パネルで、「ログ・ソース」フィールドを使用して、ログ・ソースやログ・エンティティなどのソース属性でログをフィルタできます。
ラベルでログをフィルタ
deadlock situation、memory issue、stuck thread、connection issue、abnormal terminationなど、問題のある状況を表すラベルは、問題のある状況のいずれかに一致するログ・ソースに追加されます。そのため、検索対象として問題のある状況のラベルを指定してログをフィルタできます。
Oracle Logging Analyticsの「フィールド」パネルで、「ラベル」フィールドを使用して、データ・ラベルでログ・データをフィルタできます。
オンデマンド・アップロードのデータでログをフィルタ
Oracle Logging Analyticsの「フィールド」パネルで、「アップロード名」フィールドを使用して、オンデマンド・アップロードのデータでログ・データをフィルタできます。
ログ・メッセージのフィールドでログをフィルタ
「フィールド」パネルのフィールドを使用してログを検索できます。
Oracle Logging Analyticsの「フィールド」パネルには、ログ・データをフィルタする際に使用できるフィールド属性がリストされます。
ERRORおよびNOTIFICATIONであるログのみをフィルタするには:
フィールド名の変更
renameコマンドを使用して、1つ以上のフィールド名を変更できます。
システム定義フィールドの名前を変更して、レポート生成時のフィールドの名前を制御できます。renameを参照してください。
たとえば、「ホストIPアドレス(クライアント)」フィールドの名前をclientipに変更するには、Oracle Logging Analyticsの「検索」フィールドで、次のコマンドを入力して[Enter]を押す必要があります:
* | rename 'Host IP Address (Client)' as clientip
名前の変更は、単なる実行時操作であるため、基礎となるデータ・ストレージには影響しません。
フィールド範囲でログをフィルタ
数値が含まれるフィールドの場合、bucketオプションを使用して、フィールドの値の範囲に基づいてログ・レコードをバケットにグループ化できます。結果のポップアップ・ウィンドウには、個別値ではなく範囲バケットに基づいて数およびスパークラインが表示されます。
-
フィールドの横にある「アクション」(
)アイコンをクリックします。
ダイアログ・ボックスに次のオプションが表示されます:-
フィルタ: フィールドの異なる個々の値を表示します
-
バケット: フィールドの範囲を表示します
-
-
「バケット」を選択します。
ダイアログ・ボックスで、フィールドの出現数を範囲の形式で確認できます。
選択したフィールドが円グラフ、棒グラフ、ツリーマップなどのビジュアライゼーションでレンダリングされる場合、トレンドは異なる個々の値ではなく、値の範囲に基づきます。
フィールド値を検索から除外
フィルタ結果が生成されると、レコード表を含む任意のビジュアライゼーションでフィルタ・オプションを使用して、フィールド値を検索から除外できます。ただし、検索の前に特定の値を除外する場合は、フィルターダイアログボックスで値を選択できます。
フィルタ・オプションの詳細は、「フィルタ・オプションの使用」を参照してください。