ダッシュボードの作成
Oracle定義ウィジェットまたは作成したカスタム・ウィジェットを追加して、「ダッシュボード」ページでカスタム・ダッシュボードを作成できます。また、使用可能なダッシュボードのいずれかを複製して、要件を満たすようにカスタマイズすることもできます。
トピック:
ダッシュボードとそのコンポーネントの管理については、管理ダッシュボードのドキュメントを参照してください:
-
ダッシュボードの管理: ダッシュボードへのアクセス、カスタム・ダッシュボードの作成、Oracle定義ダッシュボードのカスタマイズ、ダッシュボードのエクスポートとインポート、リージョン間ダッシュボードの設定を行います。
-
ウィジェットの管理: メトリック・データ・エクスプローラ・ウィジェットを作成し、問合せベースのウィジェットを作成して、ウィジェット・グループを追加します。
Log Analyticsの追加トピック:
-
ダッシュボードをインポートすると、ダッシュボードに保存済検索が関連付けられている場合があります。これらの保存済検索もインポートされます。CLIまたはREST APIを使用してそれらのダッシュボードをエクスポートした場合、構成ファイルには複数のダッシュボードに関する情報を含めることができます。構成ファイルには、各ダッシュボードのコンパートメントとその保存済検索に関する情報も含まれます。
-
あるテナンシから別のテナンシにダッシュボードをインポートする場合は、scopeFiltersセクションの内容で、宛先テナントの有効性を確認します。scopeFiltersセクションは、ソース・テナント内のログ・グループ・コンパートメント、リージョン、エンティティおよびログ・セットを参照します。これらのリソース値は、宛先テナントで異なります。必要に応じて、値を削除または変更します。
ダッシュボードを作成するステップ:
ダッシュボードを作成する詳細なステップは、カスタム・ダッシュボードの作成を参照してください。
Oracle Log Analyticsウィジェットでは、ログ・グループ・コンパートメント、リージョンおよびエンティティの入力によって、すべての問合せのスコープが設定されますが、問合せは変更しないでください。「入力の追加」ボタンを使用してウィジェットに追加する他のすべての入力は、述語<fieldname> = <values...>
を追加して問合せを変更します。そのためには、追加する入力には、Oracle Log Analyticsのログ・フィールド名に対応するパラメータ名が必要です。
ダッシュボードを作成したら、「ダッシュボード」ページでダッシュボードの名前をクリックして表示します。「ダッシュボード」ページの次のオプションを使用すると、他のタスクを実行できます:
- ウィジェットの「開く」
アイコンをクリックして、ログ・エクスプローラでウィジェットを開き、変更を加えます。別のユーザーによって作成されたウィジェットを変更する場合は、ログ・エクスプローラで「名前を付けて保存」オプションをクリックし、ウィジェットのコピーを作成して、要件を満たすように変更を加えます。ウィジェットのコピーはダッシュボードに自動的に追加されず、ダッシュボードを編集して追加する必要があることに注意してください。
-
「編集」をクリックして、ダッシュボードを変更します。カスタム・ウィジェット、メトリック・ウィジェットを追加または削除したり、タイトル、説明、ダッシュボード・コンパートメントまたはウィジェットに関連付けられたフィルタを変更できます。
- ダッシュボードで使用されているフィルタを非表示にするには、「スコープ・フィルタ」アイコン
をクリックします。Log Analytics全体のスコープ・フィルタとそのグローバル・コンテキストの詳細は、スコープ・フィルタの使用を参照してください。
-
ウィジェットの右下隅にある「問合せの表示」アイコン
をクリックして、ログのフィルタリングおよび分析の生成に使用される問合せを表示します。
ダッシュボードの操作に必要な権限を割り当てる管理ダッシュボード・ポリシーの詳細は、管理ダッシュボードの詳細を参照してください。
管理ダッシュボードAPIのドキュメントは、管理ダッシュボードAPIを参照してください。
Oracle定義ダッシュボードの使用
Oracle Log Analyticsには、組込みウィジェットを備えた事前定義済ダッシュボードが用意されています。
Oracle定義ダッシュボードは、重要なログの分析の概要を示すために提供されています。Oracle-defined dashboards available for Oracle Log Analytics are Enterprise Network (VCNs) Overview, OCI API Gateway Overview, OCI Audit Analysis, VCN Flow Logs, Oracle Integration: Key metrics, Oracle Integration: Time Taken Analysis, Oracle Integration: Health Overview, Oracle Database Alert, Oracle Integration Insight, Oracle Database Audit Analysis, and Oracle Database Trace Log Analysis.各ダッシュボードの詳細は、Log Analytics用のOracle定義ダッシュボードを参照してください。

Oracle定義ダッシュボードにアクセスするには、ダッシュボードへのアクセスを参照してください。Oracle Log Analyticsのすべてのビジュアライゼーションが、ネイティブ・フォームでダッシュボードに表示されます。
「ダッシュボード」ページで、「作成者」列でダッシュボードのリストをソートし、Oracle
によって作成されているものを識別します。開くダッシュボードの名前をクリックします。
ダッシュボードが開きます。ダッシュボードが作成されているログのキー・パラメータを記述するOracle定義ウィジェットを表示できます。右上隅にある時間セレクタの時間範囲を変更して、異なる時間範囲のデータを表示できます。スコープ・フィルタを使用して、Log Group Compartment
フィールドで指定することでログのスコープを定義するか、Region
およびEntity Compartment
およびEntity
フィールドを使用することでエンティティのスコープを定義できます。
ログ・エクスプローラでウィジェットを表示するには、ウィジェットの右上隅にある「ログ・エクスプローラで表示」ボタンをクリックします。
Oracle定義ダッシュボードの複製を作成し、それに別のウィジェットを追加したり、それを編集してカスタム・ダッシュボードを作成したりできます。
Oracle定義ダッシュボードをカスタマイズするには、「Oracle定義ダッシュボードをカスタマイズする」を参照してください。
特定のユースケースのフィルタの作成
フィルタの構成に使用できる様々なオプションがあります。ここでは、フィルタを作成して特定の方法でタスクを実行する必要があるユース・ケースの一部を示します。
複数のウィジェットに影響するフィルタの作成
複数のウィジェットがあり、フィルタからの同じ入力を必要とするダッシュボード(ログ・フィールドなど)がある場合があります。次に、ログ・フィールド・フィルタで選択した値が、リンクされているすべてのウィジェットに適用されます。
これは、フィルタ入力に基づいてウィジェットの出力を分析する場合に便利です。
フィルタLog Field
からの入力ログ・ソース値Linux Syslog Logs
を必要とする2つのウィジェットdb_demo
およびsqldb_demo
があるシナリオを考えてみます。次に、両方のウィジェットで使用できるフィルタを作成するには、
-
[ダッシュボード]リストページに移動し、編集する必要があるページをクリックします。「ダッシュボードの詳細」ページが開きます。「アクション」をクリックし、「編集」をクリックします。
-
「ウィジェット」ペインおよび「ウィジェットの追加」タブからウィジェットをドラッグ・アンド・ドロップします。
-
「フィルタ」ペインをクリックし、「フィルタの追加」をクリックします。
Log Source
フィールド名でログ・フィールド・フィルタを作成します。フィルタの例: ログ・フィールドを参照してください。「フィルタの編集」タブに移動し、必要に応じてログ・フィールド・フィルタのラベルを変更します。
-
「ウィジェット」ペインに移動し、「ウィジェットの編集」をクリックします。ここでは、以前に追加したウィジェット(
db_demo
やsqldb_demo
など)の両方が表示されます。各ウィジェットを展開して編集します。「入力の追加」をクリックします。「入力の構成」ダイアログ・ボックスが開きます。
オプション「入力を既存のフィルタとリンク」を選択します。「既存のフィルタの選択」メニューで、前にダッシュボードに追加したログ・フィールド・フィルタを選択します。
「変更の保存」をクリックします。
これで、入力用の両方のウィジェットを同じフィルタにリンクしました。
-
変更をダッシュボードに保存します。
これで、ダッシュボードに追加し、その後両方のウィジェットに追加した新しいフィルタが、ダッシュボードの表示中にスコープ・フィルタに表示されます。フィルタで指定する入力値(Linux Syslog Logs
など)は、ウィジェットとログの両方にただちに適用され、その値に対してフィルタ処理されます。
ウィジェットへの固定入力値の指定
入力の値が静的であり、他のフィルタに依存しないように、ウィジェットへの入力を構成できます。このような場合、入力値はウィジェットにハードコードされます。
これは通常、入力がダッシュボード内の特定のウィジェットに対してのみ1回かぎりの設定であり、複数のウィジェット間で共有する必要がない場合に必要です。
複数のログ・ソースのログを表示するウィジェットfixed_input_demo
があるシナリオを考えてみます。このウィジェットに使用される問合せは次のとおりです。
* | stats count as logrecords by 'Log Source' | sort -logrecords
ウィジェットでソースLinux Secure Logs
からのログのみを表示する必要がある場合は、パラメータLog Source
とその値Linux Secure Logs
をウィジェットに指定して、選択したソースのログのみを表示できます。
-
[ダッシュボード]リストページに移動し、編集する必要があるページをクリックします。「ダッシュボードの詳細」ページが開きます。「アクション」をクリックし、「編集」をクリックします。
-
「ウィジェット」ペインおよび「ウィジェットの追加」タブからウィジェットをドラッグ・アンド・ドロップします。
-
「ウィジェット」ペインに移動し、「ウィジェットの編集」をクリックします。ここで、以前に追加したウィジェット(
fixed_input_demo
など)が表示されます。ウィジェットを展開して編集します。「入力の追加」をクリックします。「入力の構成」ダイアログ・ボックスが開きます。
オプション「入力の指定」を選択します。パラメータ名とその値(たとえば、
Log Source
とその値Linux Secure Logs
)を指定します。「変更の保存」をクリックします。
-
変更をダッシュボードに保存します。
これで、ウィジェットは指定されたソースからのログのみを表示します。したがって、ウィジェットの有効な問合せは次のとおりです。
'Log Source' = 'Linux Secure Logs' | stats count as logrecords by 'Log Source' | sort -logrecords
1つのフィルタが他方の入力に依存する2つのフィルタの作成
入力の選択を細かく制御するには、一方のフィルタが他方からの入力を受信するようにフィルタをネストし、それをログに適用できます。
大きなログ・セットに複数のフィールド値があり、フィールドの個々の値を個別の分析に使用できる場合は、通常、このレベルの制御が必要です。また、ログの収集元となる大規模なコンポジット・ネットワークまたはインフラストラクチャがあり、特定のログにドリルダウンするためのコントロールを設定する場合。
複数のソースおよびエンティティ・タイプからログが収集されるシナリオについて考えてみます。次に、まずエンティティ・タイプでログをフィルタし、次にソースをフィルタします。そのためには、Entity Type
フィールドのログ・フィールド・フィルタを作成し、Log Source
フィールドのログ・フィールド・フィルタを作成して、その入力を最初のフィルタにリンクする必要があります。次に、ログは、スコープ・フィルタでエンティティ・タイプに対して選択した値に応じて、最初にエンティティ・タイプでフィルタされます。次に、フィルタされたログを使用して、ソース別にログを選択できます。
次のステップは、前述のシナリオのフィルタを設定するプロセスを示しています。
-
[ダッシュボード]リストページに移動し、編集する必要があるページをクリックします。「ダッシュボードの詳細」ページが開きます。「アクション」をクリックし、「編集」をクリックします。
-
Entity Type
フィールド名でログ・フィールド・フィルタを作成します。フィルタの例: ログ・フィールドを参照してください。必要に応じて、「フィルタの編集」タブに移動し、ログ・フィールド・フィルタのラベルを
Entity Type
に変更します。 -
Log Source
フィールド名でログ・フィールド・フィルタを作成します。フィルタの例: ログ・フィールドを参照してください。必要に応じて、「フィルタの編集」タブに移動し、ログ・フィールド・フィルタのラベルを
Log Source
に変更します。 -
「フィルタ」ペインに移動し、「フィルタの編集」をクリックします。ここで、前に追加したフィルタの両方が表示されます。
Log Source
のログ・フィールド・フィルタを展開します。「入力の追加」をクリックします。「入力の構成」ダイアログ・ボックスが開きます。オプション「入力を既存のフィルタとリンク」を選択します。前に追加したエンティティ・タイプ・フィルタを選択します。
「変更の保存」をクリックします。
これで、2つのフィルタが正常にリンクされました。ログ・ソースの2番目のフィルタは、値のエンティティ・タイプの最初のフィルタに依存するようになりました。そのため、エンティティ・タイプの値に基づいて、これらのログ・ソースのみが、選択したエンティティ・タイプに適用可能な選択用の2番目のフィルタに表示されます。
ウィジェットへの入力として2番目のフィルタを追加して、フィルタ入力カスケードの結果を確認します。
-
変更をダッシュボードに保存します。
ダッシュボードを表示するときに、スコープ・フィルタで、最初にエンティティ・タイプ(Host (Linux)
など)から選択できます。次に、フィルタ処理されたログ・セットから、ログ・ソースの値(Linux Audit Logs
など)を選択して、ログの最終セットを表示できます。
2番目のフィルタから選択できるオプションは、1番目のフィルタでの値の選択によって異なります。
Oracle定義フィルタの使用
Oracle Log Analyticsには、ダッシュボードを強化するために使用できる準備完了のフィルタが用意されており、分析用に選択されるログ・データを詳細に制御できます。
次のOracle定義フィルタを使用して、ログ・データをフィルタできます。
-
地域
-
ログ・グループ・コンパートメント
-
エンティティ
-
コンパートメント
-
ホスト・フィルタ
-
データベース・フィルタ
-
ログ・セット
-
ログ・フィールド
Log Analyticsフィールドのフィルタの作成の例は、フィルタの例: ログ・フィールドを参照してください。
ダッシュボードにフィルタを追加すると、複数のウィジェットでフィルタを共有できます。複数のウィジェットに影響するフィルタの作成を参照してください。
複数のフィルタを組み合せて使用すると、1つのフィルタの出力で別のフィルタの入力を制御できます。「一方のフィルタがもう一方の入力に依存する2つのフィルタの作成」を参照してください。
フィルタの例: ログ・フィールド
ログ・フィールドは、Oracle Log Analyticsで最も強力なフィルタの1つで、ログで使用可能なフィールドの範囲からの入力を指定できます。
フィールドのログ・フィールド・フィルタ(Entity Type
など)を作成すると、新しいエンティティ・タイプ入力が容易になります。この入力には、Oracle Database Instance
、WebLogic Server
、Host (Linux)
、OCI API Gateway
などの複数の値を指定できます。
この例では、エンティティ・タイプHost(Linux)
のログのフィルタを作成します。
-
[ダッシュボード]リストページに移動し、編集する必要があるページをクリックします。「ダッシュボードの詳細」ページが開きます。「アクション」をクリックし、「編集」をクリックします。
-
「フィルタ」ペインをクリックし、「フィルタの追加」をクリックします。Oracle定義フィルタのリストから、
Log Field
をクリックします。次に、ダッシュボードのフィルタ・セクションにログ・フィールド・フィルタが追加されます。「ログ・グループ・コンパートメント入力の構成」ダイアログ・ボックスが開きます。
-
ダッシュボードで使用可能なフィルタからログ・グループ・コンパートメントを選択するか、新しいフィルタを追加します。「変更の保存」をクリックします。
「ログ・フィールド名入力の構成」ダイアログ・ボックスが開きます。
-
3つのオプションのいずれかを選択して、ログ・フィールド名を指定できます。各オプションの詳細は、カスタム・ダッシュボードの作成のステップ5を参照してください。
この例では、エンティティ・タイプ・フィルタを定義するには、「ログ・フィールド名入力の指定」オプションを選択し、ドロップダウン・メニューからフィールド名を選択します。
Entity Type
を選択します。「変更の保存」をクリックします。
-
「フィルタの編集」タブに移動し、必要に応じてログ・フィールド・フィルタのラベルを変更します。
-
「ウィジェット」ペインおよび「ウィジェットの追加」タブからウィジェットをドラッグ・アンド・ドロップします。
「ウィジェット」ペインに移動し、「ウィジェットの編集」をクリックします。前に追加したウィジェットが表示されます。
ウィジェットを展開して編集します。「入力の追加」をクリックします。「入力の構成」ダイアログ・ボックスが開きます。
オプション「入力を既存のフィルタとリンク」を選択します。「既存のフィルタの選択」メニューで、前にダッシュボードに追加したログ・フィールド・フィルタを選択します。このオプションを選択すると、ダッシュボードにアクセスしたときにフィールド値を指定できます。
ただし、フィールド値を修正する場合は、オプション「入力の指定」を選択し、「パラメータ名」で、以前に選択した正確なログ・フィールド名(
Entity Type
など)を指定します。「値の入力」で、ログのフィルタ処理に使用するフィールドの値(Host(Linux)
など)を指定します。「変更の保存」をクリックします。
これで、入力用のログ・フィールド・フィルタにウィジェットをリンクしました。
-
ダッシュボードに対する変更を保存します。
ダッシュボードにアクセスして、「スコープ・フィルタ」セクションのログ・フィールド・フィルタを確認します。ウィジェットのフィールド値を固定していない場合は、スコープ・フィルタのフィールド値のオプションから選択し、分析のためにウィジェットで使用されるログを動的にフィルタできます。