9.5.2 ahf analysis
ahf analysisコマンドを使用して、AHFインサイト、AHFバランス・レポートおよびアクティビティ固有のアラート履歴を生成します。
AHF 25.11
AHF 25.11では、アクティビティ固有のアラート履歴を生成する新しい機能が導入され、AHF監視対象コンポーネント全体で発生するアクションの統一された詳細なタイムラインが提供されます。この機能により、診断機能が強化され、トラブルシューティングが加速され、システム全体の可観測性が向上します。
アクションの統合タイムライン
Oracle Databaseコンポーネントは、操作の実行中または例外の処理中に、複数のログおよびトレース・ファイルに頻繁に書き込みます。たとえば:
- Real Application Cluster (RAC)でインスタンスを停止すると、クラスタ全体の再構成イベントがトリガーされます。
- ディスク・リバランス操作は、それぞれ異なるコンポーネントによって記録される複数のステップで構成されます。
アラート履歴機能は、関連するログ・エントリとトレース・エントリを特定のアクティビティの単一で一貫性のあるタイムラインに統合し、ユーザーがイベントのシーケンスをすばやく理解できるようにします。
自動ログ解析および永続性
AHFは、コンポーネント全体で必要なログおよびトレース・ファイルを継続的に監視します。関連するエントリが自動的に抽出され、アラート履歴として保持されます。これらの永続化された履歴には、AHFコマンドライン・インタフェース(CLI)を使用してオンデマンドで簡単にアクセスできます。
問題のプロアクティブな検出とアラート
アクティビティ固有のアラート履歴を維持することで、AHFはパターンおよび潜在的な問題をプロアクティブに識別できます。これにより、障害の早期検出、応答時間の短縮、およびシステムの信頼性の向上が可能になります。
顧客のアクセシビリティ
- この機能はデフォルトで有効になっており、追加の設定は必要ありません。
- 顧客は、AHF CLIを使用してアクティビティ固有のアラート履歴を生成できます:
ahf analysis create --type alert-history <arguments>
アラート履歴の構成
アラート履歴機能はデフォルトで有効になっていますが、次のコマンドを使用して構成できます:
ahf configuration set --property ahf.collectors.alert-history --value {on|off}動作に関するノート:
- アラート履歴イベントは、プロパティ
ahf.collectors.alert-historyがonに設定されている場合にのみ索引付けされます。 - プロパティを
offに切り替えた場合、以前に生成されたアラート履歴は引き続き使用可能であり、CLIを介して表示できます。 - 有効にすると、機能するために追加の構成変更は必要ありません。
AHF 24.11
AHFバランスでは、パフォーマンス・チューニングの推奨事項に含まれるデータベースの数を制限できるようになりました。これにより、段階的な構成変更を実装しやすくなり、膨大な変更管理プロセスを必要とせずにパフォーマンスが向上します。
AHFバランスを使用したAIによるチューニング
AHFバランスは、AIを使用してデータベースのCPU_COUNTに関するチューニングの推奨事項を提供します。データベース管理者(DBA)、クラスタ管理者およびフリート管理者は、これらの推奨事項を活用して、ハードウェア使用率を最大化しながらデータベース・パフォーマンスを最適化できます。
チューニング推奨事項の柔軟性の向上
以前は、AHFバランスでは、クラスタ内のすべてのデータベースがCPU_COUNT調整の候補とみなされていました。これにより、多くの場合、50以上のデータベースでCPU_COUNTを変更する推奨事項が作成され、このような大規模な変更を同時に実装するという課題が生じました。
新しい--limit-db-changesオプションを使用すると、AHFバランスで、チューニングの推奨事項に含まれるデータベースの数を制限することで、パフォーマンスを増分的に向上されることが可能になります。これにより、管理者は、管理可能なステージで一連のチューニングを繰り返して変更を加えることができます。
ノート:
--type impactオプションを指定してahf analysisコマンドを実行する前に、最初に構成コマンドahf configuration set --type impact --user-name USER_NAME --connect-string CONNECT-STRINGを実行してください。
このステップは、分析を実行する前に必要な接続詳細を設定するために必要です。
- フリート分析:
フリートの分析を実行し、クラスタ間でデータベース変更の数を制限するには、次のコマンドを使用します:
ahf analysis create --type impact --scope fleet --name <fleet-name> --limit-db-changes <positive-integer-number-of-databases> - クラスタ分析:
特定のクラスタの分析を実行し、データベース変更の数を制限するには、次のコマンドを使用します:
ahf analysis create --type impact --scope cluster --name <cluster-name> --limit-db-changes <positive-integer-number-of-databases> - クラスタ内のデータベース分析:
クラスタ内の特定のデータベースの分析を実行するには、次のコマンドを使用します:
ahf analysis create --type impact --scope database --name <db-name> --cluster <cluster-name> --limit-db-changes <positive-integer-number-of-databases>
データベースの変更を制限することで、AHFバランスによって、パフォーマンス・チューニングに対するより制御された効率的なアプローチが提供され、よりスムーズな実装と改善された結果が実現されます。
AHF 23.8
AHF 23.8以降では、オブジェクト・ストアがAHFの一部として構成されている場合に、AHFインサイト・レポートを自動的にアップロードできます。AHFインサイト・レポートをアップロードすると、Oracle Cloud Operationsでベスト・プラクティス構成におけるシステム・ヘルス問題点および相違点を迅速かつ効率的に特定、調査、追跡および解決するために役立ちます。
Oracle Autonomous Database on Dedicated Exadata InfrastructureおよびOracle SaaS
ahfctl setupload -name oss -type https -user <user> -url <object_store> -passwordahf analysis create --type insightsahf analysis create
ahf analysis create [-h] [--type {insights|impact}] [[--last n{m|h} [--refresh] | --for DATETIME | --from DATETIME --to DATETIME] [--tag TAGNAME] | [--scope SCOPE --name NAME --cluster CLUSTER --clusters CLUSTER_LIST]][--output-file PATH] [--to-json]ahf analysis create [-h] [--type {alert-history|patch-summary|capacity|insights|impact}] [--component COMPONENT] [--last n{m|h} | --from DATETIME --to DATETIME] [--instance INSTANCE] [--database DATABASE] [--from DATETIME --to DATETIME] [--diskgroup DISK_GROUP] [--disknumber DISK_NUMBER] [--diskname DISK_NAME] [--severity SEVERITY] [--scenario SCENARIO] [--metric METRIC --cluster CLUSTER] [--nodes NODES] [--from DATETIME --to DATETIME] [--last n{m|h} [--refresh] | --for DATETIME | --from DATETIME --to DATETIME] [--tag TAGNAME] [--scope SCOPE --name NAME --cluster CLUSTER --clusters CLUSTER_LIST] [--output-file PATH]構文: AHFバランス
ahf analysis create [-h] --type impact --scope [fleet|cluster|database] [--cluster CLUSTER_NAME] [--clusters space-delimited list of clusters
] [--em-group] --name NAMEパラメータ
表9-125 ahf analysis create --type impactコマンドのパラメータ
| パラメータ | 説明 |
|---|---|
|
|
このヘルプを表示して終了します。 |
|
|
生成するレポートのタイプを指定します。 |
|
|
AHFバランス・レポート(フリート・レポート、クラスタ・レポートおよびデータベース・レポート)を生成するように指定します。 影響分析を作成するには、 データベースの影響の分析には、 |
|
|
指定された場所に出力ファイルを作成するように指定します。 |
|
|
フリート・スコープに含めるクラスタのスペース区切りリストを指定します。 |
|
|
レポートするフリート、EMグループ、クラスタまたはデータベースの名前を指定します。 ノート: フリートの名前には、MyFleetなど、任意の名前を指定できます。レポートにラベルを付けるためにのみ使用されます。 |
|
|
EMグループ名を指定します。 ノート: このオプションは、--clustersオプションとは相互に排他的であり、--scope fleetオプションとともに使用する必要があります。
たとえば:
|
|
|
Oracle Enterprise Managerリポジトリのユーザー名を指定します。 ノート: AHFバランスが構成されている場合は必要ありません。詳細は、「ahf configuration」を参照してください。 |
|
|
Oracle Enterprise Managerリポジトリの接続文字列を指定します。 ノート: AHFバランスが構成されている場合は必要ありません。詳細は、「ahf configuration」を参照してください。 |
|
|
推奨されるデータベース変更の数を制限します。 |
構文: AHFインサイト
ahf analysis create [-h] --type insights [--last n{m|h} | --for DATETIME | --from DATETIME --to DATETIME] [--refresh] [--tag TAGNAME
]パラメータ
表9-126 ahf analysis create --type insightsコマンドのパラメータ
| パラメータ | 説明 |
|---|---|
|
|
このヘルプを表示して終了します。 |
|
|
生成するレポートのタイプを指定します。 |
|
|
過去の分数(m)または時間数(h)のデータを分析するには、
|
|
|
指定したタイムスタンプの前後2時間のデータを分析するには、 サポートされている時間書式は次のとおりです。
|
|
|
特定の時間間隔のデータを分析するには、 サポートされている時間書式は次のとおりです。
開始時間と終了時間の差は4時間を超えることはできません。 |
|
|
AHFインサイト・ソースから新規データを提供します。 AHFインサイト・ソースから新規データを提供するには、 |
|
|
セルのデータをAHFインサイト・ソースに含めるように指定します。 |
|
|
リポジトリ内のTAGNAMEディレクトリにファイルを収集するように指定します。 |
構文: ahf analysis explore
ahf analysis explore [-h] [--with scope] [--from-file FILE]ノート:
Oracle AI Database 26ai以降では、ahf analysis explore --with scopeコマンドはサポートが終了しています。GIMRの詳細は、「問題の根本原因の分析」を参照してください。
パラメータ
表9-127 ahf analysis exploreコマンドのパラメータ
| パラメータ | 説明 |
|---|---|
|
|
このヘルプを表示して終了します。 |
|
|
ファイルから読み取るように指定します。 ファイル拡張子を指定しない場合、AHFスコープはファイル拡張子として |
構文: AHFアラート履歴
ahf analysis create [-h] [--type {alert-history|patch-summary|capacity|insights|impact}] [--component COMPONENT] [--last n{m|h} | --from DATETIME --to DATETIME] [--instance INSTANCE] [--database DATABASE] [--from DATETIME --to DATETIME] [--diskgroup DISK_GROUP] [--disknumber DISK_NUMBER] [--diskname DISK_NAME] [--severity SEVERITY] [--scenario SCENARIO] [--metric METRIC --cluster CLUSTER] [--nodes NODES] [--from DATETIME --to DATETIME] [--last n{m|h} [--refresh] | --for DATETIME | --from DATETIME --to DATETIME] [--tag TAGNAME] [--scope SCOPE --name NAME --cluster CLUSTER --clusters CLUSTER_LIST] [--output-file PATH]パラメータ
表9-128 ahf analysis create --type alert historyコマンドのパラメータ
| パラメータ | 説明 |
|---|---|
|
|
このヘルプを表示して終了します。 |
|
|
出力をJSON形式で表示します。 |
|
|
分析するコンポーネントを指定します。現在、アラート履歴では |
|
|
インスタンス名で結果をフィルタします。 |
|
|
ASMディスク・グループ名を指定します。 |
|
|
ASMディスク・グループ内のディスク番号を指定します。 |
|
|
ASMディスク・グループ内のディスク名を指定します。 |
|
|
重大度でアラートをフィルタします。サポートされている値は、 |
|
|
シナリオ名を指定します。 |
|
|
指定した開始時間からデータを分析します。次の形式を受け入れます:
|
|
|
指定した終了時間までのデータを分析します。 |
|
|
過去'n'分( |
コマンドの使用例
特定のコンポーネント、時間範囲またはリソースのアラート履歴分析を作成するには、次のオプションを使用します:
[--component COMPONENT] [--instance INSTANCE]
[--from DATETIME --to DATETIME]
[--diskgroup DISK_GROUP] [--disknumber DISK_NUMBER] [--diskname DISK_NAME]
[--severity SEVERITY] [--scenario SCENARIO]コンポーネント、インスタンス、ディスク・グループ、ディスク番号、ディスク名、重大度およびシナリオでアラート履歴をフィルタできます。
ノート:
- 異なるディスク・グループ内のディスクは、同じ名前を共有できます。
--disknameを--diskgroupとともに使用することをお薦めします。 - ディスク番号は、ディスク・グループ間で重複する場合もあります。正確にフィルタするには、
--disknumberを--diskgroupとともに使用します。
- 特定の時間範囲のアラート履歴分析を作成します:
ahf analysis create --type alert-history --from 2022-10-10T14:00:00Z --to 2022-10-10T15:30:00Z - コンポーネントおよびインスタンスでフィルタします:
ahf analysis create --type alert-history --component ASM --instance +asm1 - ディスク・グループおよび重大度でフィルタします:
ahf analysis create --type alert-history --diskgroup DG1 --severity info
重要:
- アラート履歴メッセージ生成は現在、ASMコンポーネントでのみサポートされています。
- このリリースでは、
dismount、dismount_force、offlineおよびmountのシナリオがサポートされています。 - アラート履歴は、過去30日以内の時間範囲に対してのみ使用できます。
例9-125 AHFインサイト分析の使用例
特定の期間の分析を作成するには、[--last | --for | --from --to]を指定します。許容される最大時間間隔は4時間です。
AHFインサイト・ソースから新規データを提供するには、[--refresh]を単独で、または[--last]とともに指定します。
- 過去3時間に収集されたデータから分析レポートを作成します。
ahf analysis create --type insights --last 3h - 指定したタイムスタンプを中心とした2時間の分析を作成します。
ahf analysis create --type insights --for 2022-10-10T14:00:00 - 指定した時間範囲の分析を作成します。
ahf analysis create --type insights --from 2022-10-10T14:00:00 --to 2022-10-10T15:30:00 - タイムゾーンを指定して分析を作成します。
ahf analysis create --type insights --from 2022-10-10T14:00:00 --to 2022-10-11T13:30:00 - 最新のデータを使用して分析を作成します。
ahf analysis create --type insights --refresh - タグを使用して分析を作成します:
ahf analysis create --type insights --tag my_tag
例9-126 AHFバランスの使用例
影響分析を作成するには、[--scope]および[--name]オプションを指定します。
データベースの影響の分析には、[--cluster]オプションが必要です。
- フリート(すべてのクラスタ)の分析を作成します。
ahf analysis create --type impact --scope fleet --name fleet1 - フリート(クラスタ・リスト)の分析を作成します。
ahf analysis create --type impact --scope fleet --name fleet1 --clusters clu1 clu2 clu3 - クラスタの分析を作成します。
ahf analysis create --type impact --scope cluster --name cluster1 - データベースの分析を作成します。
ahf analysis create --type impact --scope database --cluster cluster1 --name database1 - 出力ディレクトリを指定して分析を作成します:
ahf analysis create --type impact --scope fleet --name fleet1 --output-file /custom_path/custom_name.html - EMリポジトリのユーザー名とパスワードを指定して分析を作成します:
ahf analysis create --type impact --scope fleet --name fleet1 --user-name oracle --connect-string <cs>
例9-127 AHFアラート履歴の使用例
- 特定のディスク・グループ・マウント・イベントのアラート履歴分析を作成します:
# ahf analysis create --type alert-history --scenario mount Alert Summary: Host : hostname1 ----------------------- [2025-10-22T05:00:48.128+00:00] [INFO] [+ASM1] Diskgroup 1 (DATAC2): Mounted with the following properties Redundancy Type: high compatible.asm: 11.2.0.4.0 compatible.rdbms: 11.2.0.3.0 Mount Incarnation: 0x0D57CFC0 Creation timestamp: 2024/11/06 22:57:08 Host : hostname2 ----------------------- No alert history found for input parameters - 特定のディスク・グループ内のASMディスク・オフライン・イベントのアラート履歴分析を作成します:
# ahf analysis create --type alert-history --component ASM --scenario offline --severity info --diskname DATAFILE --diskgroup 2 Alert Summary: Host : hostname --------------- [2024-10-05T10:23:12.775+00:00] [INFO] [aime111] Diskgroup 2 (DATAFILE): Disk 0 (DATAFILE0) is being offlined because x000 process with OS PID 13420 is expelling the disk from the diskgroup [2024-10-05T10:23:18.775+00:00] [INFO] [aime111] Diskgroup 2 (DATAFILE): Disk 0 (DATAFILE_0000) is being offlined because r000 process with OS PID 24167 could not read from the disk when repairing ASM file 9 extent 0
親トピック: 統合AHF CLI管理コマンドの実行