Performance Insights API for Aurora によるメトリクスの取得 - Amazon Aurora

Performance Insights API for Aurora によるメトリクスの取得

Performance Insights がオンになっている場合、API はインスタンスのパフォーマンスを可視化します。Amazon CloudWatch Logs は、AWS のサービスをモニタリングしたメトリクスの信頼性のある提供元です。

Performance Insightsは、平均アクティブ・セッション(AAS)として測定されるデータベースロードのドメイン固有のビューを提供します。このメトリクスはAPI利用者には2次元時系列データセットのように見えます。データの時間ディメンションは、クエリされた時間範囲内の各時点のDBロード・データを提供します。各時点で、その時点で計測された SQLWait-eventUserHost などのリクエストされたディメンションに関する負荷全体が分解されます。

Amazon RDS Performance Insights では、 Amazon Aurora DB クラスターをモニタリングし、データベースパフォーマンスの分析とトラブルシューティングを行うことができます。Performance Insights は、AWS Management Console で表示することができます。また、Performance Insights では独自のデータをクエリできるように、パブリック API も提供されています。API を使用して、次を実行できます。

  • データベースにデータをオフロードする

  • Performance Insights データを既存のモニタリングダッシュボードに追加する

  • モニタリングツールを構築する

Performance Insights API を使用するには、いずれかの Amazon RDS DB インスタンスで Performance Insights を有効にします。Performance Insights の有効化については、「Aurora の Performance Insights の有効化と無効化」を参照してください。Performance Insights API の詳細については、「Amazon RDS Performance Insights API リファレンス」を参照してください。

Performance Insights API は、以下のオペレーションを提供します。

Performance Insights でのアクション

AWS CLI コマンド

説明

CreatePerformanceAnalysisReport

aws pi create-performance-analysis-report

DB インスタンスの特定の期間のパフォーマンス分析レポートを作成します。結果は、レポートの固有識別子である AnalysisReportId です。

DeletePerformanceAnalysisReport

aws pi delete-performance-analysis-report

パフォーマンス分析レポートを削除します。

DescribeDimensionKeys

aws pi describe-dimension-keys

特定の期間に、メトリクスの上位 N 個のディメンションキーを取得します。

GetDimensionKeyDetails

aws pi get-dimension-key-details

DB インスタンスまたはデータソースの指定されたディメンショングループの属性を取得します。例えば、SQL ID を指定し、ディメンションの詳細が使用可能な場合、GetDimensionKeyDetails は、この ID に関連付けられているディメンション db.sql.statement の全文を取得します。このオペレーションは、GetResourceMetrics および DescribeDimensionKeys が大きな SQL ステートメントテキストの取得をサポートしないため、便利です。

GetPerformanceAnalysisReport

aws pi get-performance-analysis-report

レポートのインサイトを含むレポートを取得します。結果には、レポートのステータス、レポート ID、レポート時間の詳細、インサイト、および推奨事項が含まれます。

GetResourceMetadata

aws pi get-resource-metadata

さまざまな機能に関するメタデータを取得します。例えば、メタデータにより、特定の DB インスタンスで何等かの機能が有効化されているか無効化されているかを、示すことができます。

GetResourceMetrics

aws pi get-resource-metrics

期間中、データソースのセットに Performance Insights のメトリクスを取得します。特定のディメンショングループおよびディメンションを提供し、各グループの集約とフィルタリング条件を提供することができます。

ListAvailableResourceDimensions

aws pi list-available-resource-dimensions

指定したインスタンスで、指定したメトリクスタイプごとにクエリできるディメンションを取得します。

ListAvailableResourceMetrics

aws pi list-available-resource-metrics

DB インスタンスを指定しながら、指定されたメトリクスタイプでクエリが可能なメトリクスをすべて取得します。

ListPerformanceAnalysisReports

aws pi list-performance-analysis-reports

DB インスタンスについて入手可能なすべての分析レポートを取得します。レポートは、各レポートの開始時間に基づいて一覧表示されます。

ListTagsForResource

aws pi list-tags-for-resource

リソースに追加されたすべてのメタデータタグを一覧表示します。リストには、タグの名前と値が含まれます。

TagResource

aws pi tag-resource

Amazon RDS リソースにメタデータタグを追加します。タグには名前と値が含まれます。

UntagResource

aws pi untag-resource

メタデータタグをリソースから削除します。

Performance Insights の時系列メトリクスの取得と AWS CLI の例の詳細については、以下のトピックを参照してください。