翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # Amazon Quick でのインシデント対応、ログ記録、モニタリング | | | --- | |    対象者: システム管理者と Amazon Quick 管理者  | Amazon Quick インスタンスのセキュリティ、パフォーマンス、信頼性を維持するには、効果的なインシデント対応、ログ記録、モニタリングが不可欠です。このモニタリングフレームワークは、チャット、スペース、フロー、アクション、調査、ダッシュボード、カスタムエージェントなど、すべての Amazon Quick 機能のユーザーアクティビティ、システムパフォーマンス、セキュリティイベント、運用メトリクスを複数レイヤーで可視化します。 Amazon Quick は、 AWS ネイティブのモニタリングおよびログ記録サービスと統合して、リアルタイムのインサイトと履歴分析機能の両方を提供します。モニタリングシステムは、ユーザーエンゲージメント、会話パターン、リソース使用率、セキュリティ関連のイベントに関する詳細な分析をキャプチャし、CloudTrail ログ記録はコンプライアンスとフォレンジック分析の完全な監査証跡を保証します。 このセクションでは、以下について説明します。 + **分析とモニタリング** - すべての Amazon Quick 機能にわたるユーザーの採用、パフォーマンス、フィードバック、セキュリティイベントを追跡するための包括的なダッシュボードとメトリクス + **CloudTrail ログ**記録 - Amazon Quick Sight でのコンプライアンスとセキュリティのモニタリングのための API コールと管理アクションの監査証跡を完了する + **API 以外のイベントログ**記録 - API コールを生成しないユーザーインタラクション、コンテンツアクセス、およびシステムイベントのモニタリング + **ログの分析と解釈** - ログエントリの理解、セキュリティインシデントの特定、Amazon Quick Sight での運用上の問題への対応 セキュリティインシデントの調査、ユーザー動作パターンの分析、システムパフォーマンスの測定、規制コンプライアンスの確保など、これらのモニタリングおよびログ記録機能は、安全で適切に機能する Amazon Quick 環境を維持するために必要な可視性とデータを提供します。 **Topics** + [CloudWatch Logs を使用した Amazon Quick 使用状況のモニタリング](monitoring-quicksuite-chat-feedback-cloudwatch.md) + [CloudTrail を使用した Amazon Quick Sight でのインシデント対応、ログ記録、モニタリング](incident-response-logging-and-monitoring-qs.md) + [CloudWatch を使用した Amazon Quick Sight のデータのモニタリング](monitoring-quicksight.md) # CloudWatch Logs を使用した Amazon Quick 使用状況のモニタリング [Amazon CloudWatch Logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html) を使用して、Amazon Quick でチャット会話、ユーザーフィードバック、エージェント/研究時間の使用状況を配信し、分析できます。これらのログは、CloudWatch、Amazon S3、Amazon Data Firehose などの複数の宛先に配信できます (標準料金が適用されます）。Amazon Quick AI 機能を有効にした直後に、販売ログを設定することをお勧めします。 Amazon Quick のログを使用して実行できるタスクの例を次に示します。 + チャットメッセージの内容を確認して、一般的なユーザークエリと問題点を特定する。 + `feedbackReason` などのメトリクスを確認して、応答の品質をモニタリングする。 + コメントや有用性評価などのフィードバックデータを分析することで、ユーザーの感情と満足度を理解する。 + カスタムダッシュボードとレポートを生成して、主要なメトリクスと傾向を経時的に追跡する。 + チャットが応答を返さないか、ユーザークエリがブロックされたケースを特定して分析する + エージェントと研究時間の使用状況をモニタリングする **重要** 会話のログには、チャットで渡される機密データや個人を特定できるデータが含まれる場合があります。ログサブスクリプションを設定するときに、ログからこの情報を除外できます。または、CloudWatch Logs マスキングポリシーを使用して、ログでこのデータをマスキングすることもできます。詳細については、「[Help protect sensitive log data with masking](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/mask-sensitive-log-data.html)」を参照してください。 ## サポートされているログの送信先 Amazon Quick は、次の宛先にログを配信できます。 + **Amazon CloudWatch Logs** - リアルタイムのモニタリングと分析用 + **Amazon S3** - 長期ストレージとバッチ処理用 + **Amazon Data Firehose** - ストリーミング分析とデータ変換用 ## 前提条件 ログ記録を有効にする前に、以下を確認してください。 + Enterprise または Professional サブスクリプションを使用するアクティブな Amazon Quick インスタンス + ログ配信を設定するための適切な IAM アクセス許可 + ログ用に設定された送信先 (CloudWatch Logs、Amazon S3 バケット、または Firehose) ## のログ記録の設定 Amazon Quick Chat とフィードバックのログ記録を有効にするには、IAM アクセス許可を設定し、配信ソースと配信先を作成し、ログが正常に配信されていることを確認する必要があります。 **Topics** + [IAM 許可をセットアップする](#quicksuite-chat-feedback-setup-iam-permissions) + [ログサブスクリプションを設定する](#quicksuite-chat-feedback-configure-log-subscription) + [ログ配信の検証](#quicksuite-chat-feedback-verify-log-delivery) ### IAM 許可をセットアップする Amazon Quick の CloudWatch Logs を設定するには、次の IAM ポリシー例を使用して必要なアクセス許可を付与します。 ``` { "Version": "2012-10-17" , "Statement": [{ "Sid": "QuicksightLogDeliveryPermissions", "Effect": "Allow", "Action": "quicksight:AllowVendedLogDeliveryForResource", "Resource": "arn:aws:quicksight:region:account-id:account/account-id" }] } ``` また、カスタマーマネージド AWS KMS キーポリシーで`delivery.logs.amazonaws.com`サービスプリンシパルを許可する必要があります。 ``` { "Effect": "Allow" , "Principal": { "Service": "delivery.logs.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:SourceArn": "arn:partition:logs:region:account-id:*" } } } ``` ### ログサブスクリプションを設定する 特定のログ記録先に必要なすべてのアクセス許可を持つ IAM ポリシーの例については、*Amazon CloudWatch Logs* [ユーザーガイド」の AWS 「サービスからのログ記録](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AWS-logs-and-resource-policy.html)を有効にする」を参照してください。 [PutDeliverySource](https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDeliverySource.html) CloudWatch Logs API オペレーションを使用して配信ソースを作成します。配信ソースに名前を付け、`resourceArn` でアプリケーションの ARN を指定します。の場合は`logType`、`CHAT_LOGS`、、`AGENT_HOURS_LOGS`または を指定します。 `FEEDBACK_LOGS` ``` { "logType": "CHAT_LOGS", "name": "my-quick-suite-delivery-source", "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id" } ``` ``` { "logType": "FEEDBACK_LOGS", "name": "my-quick-suite-delivery-source", "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id" } ``` ``` { "logType": "AGENT_HOURS_LOGS", "name": "my-quick-suite-delivery-source", "resourceArn": "arn:aws:quicksight:your-region:your-account-id:account/account-id" } ``` CloudWatch Logs API オペレーションでユーザー会話のログ記録を有効にするには、`PutDeliverySource`、`PutDeliveryDestination`、および `CreateDelivery` API オペレーションを呼び出します。 **注記** ログは、`PutDeliverySource`入力のリソース ARN に記載されているリージョンで使用できます。 ### ログ配信の検証 設定したら、ログが送信先に配信されていることを確認します。 + **セットアップを確認する:** CloudWatch Logs の `DescribeDeliveries` API を使用して、アカウントで作成された配信のリストを確認します。 + **CloudWatch Logs**: 指定されたロググループで新しいログストリームを確認します。 + **Amazon S3**: 新しいログファイルがないかバケットをモニタリングします。 + **Firehose**: データが配信ストリームを流れることを確認します。 ## ログスキーマと形式 Amazon Quick Logs は、チャットログとフィードバックログのすべてのログタイプと特定のフィールドで共有される共通のフィールドを持つ構造化スキーマに従います。 ### 共通フィールド すべてのログイベントには、次の共通フィールドが含まれます。 + `resource_arn` - Amazon Quick アカウントのリソース ARN (例: `arn:aws:quicksight:us-east-1:111122223333:account/111122223333:`) + `event_timestamp` - イベントの ISO 8601 タイムスタンプ (例: `1763532110061`) + `logType` - ログのタイプ (例: `Chat`または `Feedback`) + `accountId` - AWS アカウント ID (例: `123456789012`) + `user_arn` - イベントに関連付けられた Amazon Quick ユーザー ARN (例: `"arn:aws:quicksight:us-west-2:111122223333:user/default/user"`) ### チャットログ チャットログは会話のやり取りをキャプチャし、以下のフィールドを含みます。 + `status_code` - チャットリクエストのステータス (例: `Success, request_blocked, no_answer_found` ) + `namespace*` - イベントの Amazon Quick 名前空間 (例: `default`) + `user_type` - イベントに関連付けられた Amazon Quick ユーザータイプ (例: `ADMIN_PRO`) + `conversation_id` - ユーザー会話の一意の ID + `system_message_id` - システムによって生成されたメッセージ ID + `latency*` - ミリ秒単位のチャットメッセージのレイテンシー + `time_to_first_token*` - 最初のレスポンストークンのミリ秒単位の時間 + `message_scope` - メッセージの範囲 (例: `all_resources, specific_resources, no_resources` ) + `user_message_id` - ユーザーメッセージの一意の ID + `user_message` - 会話のユーザーメッセージ + `agent_id` - チャットエージェントの一意の ID + `flow_id` - Amazon Quick Flow の一意の ID + `system_text_message` - 会話中のシステムレスポンス + `surface_type*` - 会話に使用されているアプリケーション + `web_search*` - ウェブ検索が有効かどうか + `user_selected_resources`- ユーザーによって選択されたリソースのリスト + `action_connectors` - アクションコネクタのリスト + `cited_resource` - 引用されたリソースのリスト + `file_attachment` - ユーザーによってアタッチされたファイルのリスト チャットログの例を次に示します。 ``` { "status_code": "success", "namespace": "default", "user_type": "ADMIN_PRO", "conversation_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d", "system_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d", "latency": "10000", "time_to_first_token": "10000", "message_scope": "all_resources", "user_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d", "user_message": "Hi chat", "agent_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d", "flow_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d?", "system_text_message": "Hello user", "surface_type": "WEB_EXPERIENCE", "web_search": "true" "user_selected_resources": [{"resource_type": "Dashboard","resource_id": "146abs-1222-534894"},{"resource_type": "Space","resource_id": "123abs-1234-534894"}], "action_connectors": [{"action_connector_id": "quicksight-website"},{"action_connector_id": "123abs-1234-534894"}] "cited_resource": [{"cited_resource_name": "Dashboard","cited_resource_id": "146abs-1222-534894","cited_resource_name": "ds1"},{"cited_resource_name": "Space","cited_resource_id": "123abs-1234-534894","cited_resource_name": "space1"}], "file_attachment": [{"file_attachmet_type": "pdf","file_attachment_name": "file1.pdf"},{"file_attachmet_type": "txt","file_attachment_name": "file2.txt"}] } ``` ### フィードバックログ フィードバックログは、チャットに関するユーザーフィードバックをキャプチャし、以下のフィールドを含みます。 + `status_code` - イベント配信のステータス + `namespace*` - イベントの Amazon Quick 名前空間 (例: `default`) + `user_type` - イベントに関連付けられた Amazon Quick ユーザータイプ (例: `ADMIN_PRO`) + `conversation_id` - 会話の一意の ID + `system_message_id` - システムによって生成されたメッセージ ID + `user_message_id` - ユーザーメッセージの一意の ID + `feedback_type` - フィードバックのタイプ (例: `Not Useful, Useful` ) + `feedback_reason` - ユーザーが選択したフィードバックの理由 + `feedback_details` - (オプション) ユーザーが提供する追加の詳細 フィードバックログの例を次に示します。 ``` { "status_code": "success", "namespace": "default", "user_type": "ADMIN_PRO", "conversation_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d", "system_message_id": "a11b2bbc-c123-3abc-a12b-12a34b5c678d", "user_message_id" : "a11b2bbc-c123-3abc-a12b-12a34b5c678d", "feedback_type" :"Not Useful / Useful" "feedback_reason" : "Too wordy,Issue with sources,Other etc." "feedback_details" : "additional text shared by user" } ``` ## エージェント/研究時間のログ このログタイプは、料金に使用されるクイックアカウント内のさまざまなエージェントの使用状況ログをキャプチャします。 + `subscription_type` - エンタープライズまたはプロフェッショナル + `reporting_service` - エージェントに対応するサービス: RESEARCH、FLOWS、AUTOMATIONS + `usage_group` - これまでのサブスクリプションタイプと使用状況`Included or Extra`に基づく + `usage_hours` - 特定のログインスタンスの使用時間を示す 10 進値 + `service_resource_arn` - 対応するエージェントのサービスの ARN エージェント時間ログの例を次に示します。 ``` { "subscription_type": "ENTERPRISE", "reporting_service": "RESEARCH", "usage_group": "Included", "usage_hours": 0.3333, "service_resource_arn": "arn:aws:quicksight:eu-west-1:111222333444:research/a11b2bbc-c123-3abc-a12b-12a34b5c678d" } ``` **注記** \$1 「\$1」とマークされたフィールドは、デフォルトではログサブスクリプションに追加されません。これらは、必要に応じて CreateDelivery を呼び出すときに明示的に指定する必要があります。 ## セキュリティに関する考慮事項 + **暗号化**: 機密データにカスタマーマネージド AWS KMS キーを使用する + **アクセスコントロール**: 最小特権の IAM ポリシーを実装する + **データ保持**: コンプライアンス要件に適した保持ポリシーを設定する # CloudTrail を使用した Amazon Quick Sight でのインシデント対応、ログ記録、モニタリング Amazon Quick Sight は と統合されています AWS CloudTrail。このサービスは、Amazon Quick Sight のユーザー、ロール、または AWS サービスによって実行されたアクションの記録を提供します。CloudTrail は、Amazon Quick Sight のすべての API コールをイベントとしてキャプチャします。キャプチャされた呼び出しには、Amazon Quick Sight コンソールからの呼び出しと、Amazon Quick Sight API オペレーションへのすべてのコード呼び出しが含まれます。証跡を作成する場合は、Amazon S3 バケットへの CloudTrail イベントの継続的な配信を有効にすることができます。証跡を設定しない場合でも、CloudTrail コンソールの **[イベント履歴]** で最新のイベントを表示できます。CloudTrail で収集された情報を使用して、Amazon Quick Sight に対するリクエスト、リクエスト元の IP アドレス、リクエスト者、リクエスト日時などの詳細を確認できます。 Amazon Quick Sight は、Amazon CloudWatch やその他の外部システムでのアラートをネイティブにサポートしていません。ただし、CloudTrail ログを処理するようにカスタムのソリューションを開発することができます。 Amazon Quick Sight サービスのステータスは、[サービスヘルスダッシュボード](https://status.aws.amazon.com/)で確認できます。 デフォルトでは、CloudTrail によってバケットに配信されるログファイルは、Amazon の [Amazon S3 で管理された暗号化キーによるサーバー側の暗号化 (SSE-S3)](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html) によって暗号化されます。直接管理可能なセキュリティレイヤーを提供するには、代わりに CloudTrail ログファイルの [AWS KMS マネージドキー (SSE-KMS) によるサーバー側の暗号化](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html)を使用できます。サーバー側の暗号化を有効にすると SSE-KMS、を使用してログファイルが暗号化されますが、ダイジェストファイルは暗号化されません。ダイジェストファイルは、[Amazon S3 で管理された暗号化キー (SSE-S3)](https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html) を使用して暗号化されます。 設定や有効化の方法など、CloudTrail の詳細については、[AWS CloudTrail ユーザーガイド](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)を参照してください。 **Topics** + [を使用した Amazon Quick Sight 情報のログ記録 AWS CloudTrail](#logging-using-cloudtrail) + [CloudTrail ログを使用した API 以外のイベントの追跡](#logging-non-api) + [例: Amazon Quick Sight ログファイルエントリ](#understanding-quicksight-entries) ## を使用した Amazon Quick Sight 情報のログ記録 AWS CloudTrail | | | --- | |    対象者: システム管理者  | CloudTrail は、 AWS アカウントの作成時にアカウントで有効になります。Amazon Quick Sight でサポートされているイベントアクティビティが発生すると、そのアクティビティはイベント**履歴**の他の AWS サービスイベントとともに CloudTrail イベントに記録されます。 AWS アカウントで最近のイベントを表示、検索、ダウンロードできます。詳細については、[CloudTrail イベント履歴でのイベントの表示](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)を参照してください。 Amazon Quick Sight のイベントなど、 AWS アカウントのイベントの継続的な記録については、証跡を作成します。*証跡*により、CloudTrail はログファイルを Amazon S3 バケットに配信できます。デフォルトでは、コンソールで証跡を作成するときに、証跡がすべての に適用されます。証跡は、 AWS パーティションのすべてのリージョンからのイベントをログに記録し、指定した Amazon S3 バケットにログファイルを配信します。さらに、CloudTrail ログで収集されたイベントデータをさらに分析して処理するように他の AWS サービスを設定できます。詳細については、次を参照してください: + [証跡の作成のための概要](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html) + [CloudTrail がサポートするサービスと統合](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations) + [CloudTrail 用 Amazon SNS 通知の構成](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html) + [複数のリージョンから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html)および[複数のアカウントから CloudTrail ログファイルを受け取る](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) + 「 AWS Lake Formation デベロッパーガイド」の[「クロスアカウント CloudTrail ログ記録](https://docs.aws.amazon.com/lake-formation/latest/dg/cross-account-logging.html)」 – このトピックには、クロスアカウント CloudTrail ログにプリンシパル ID を含める手順が含まれています。 Amazon Quick Sight は、CloudTrail ログファイルのイベントとして次のアクションのログ記録をサポートしています。 + リクエストがルート認証情報または AWS Identity and Access Management ユーザー認証情報を使用して行われたかどうか + リクエストが、IAM ロールまたはフェデレーティッドユーザーの一時的なセキュリティ認証情報によって行われたか + リクエストが別の AWS サービスによって行われたかどうか ユーザー ID の詳細については、[CloudTrail userIdentity 要素](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html)を参照してください。 デフォルトでは、各 Amazon Quick Sight ログエントリには以下の情報が含まれます。 + **userIdentity** – ユーザー ID + **eventTime** – イベント時間 + **eventId** – イベント ID + **readOnly** – 読み取り専用 + **awsRegion** – AWS リージョン + **eventSource (quicksight)** – イベントのソース (Amazon Quick Sight) + **eventType (AwsServiceEvent)** – イベントタイプ (AWS サービスイベント) + **recipientAccountId (顧客 AWS アカウント)** – 受信者アカウント ID (顧客 AWS アカウント) **注記** CloudTrail は、Amazon Quick Sight によってプロビジョニングされた`unknown`かのようにユーザーを表示します。このように表示されるのは、これらのユーザーが既知の IAM ID のタイプではないためです。 ## CloudTrail ログを使用した API 以外のイベントの追跡 以下に示しているのは、追跡可能な API 以外のイベントのリストです。 **ユーザー管理** + **CreateAccount** – アカウントの作成 + **BatchCreateUser** – ユーザーの作成 + **BatchResendUserInvite** – ユーザーの招待 + **UpdateGroups** – グループの更新 このイベントは Enterprise Edition でのみ機能します。 + **UpdateSpiceCapacity** – SPICE 容量の更新 + **DeleteUser** – ユーザーの削除 + **Unsubscribe** – ユーザーのサブスクリプション解除 **サブスクリプション** + **CreateSubscription** – サブスクリプションの作成 + **UpdateSubscription** – サブスクリプションの更新 + **DeleteSubscription** – サブスクリプションの削除 **ダッシュボード** + **GetDashboard** – ダッシュボードの取得 + **CreateDashboard** – ダッシュボードの作成 + **UpdateDashboard** – ダッシュボードの更新 + **UpdateDashboardAccess** – ダッシュボードアクセスの更新 + **DeleteDashboard** – ダッシュボードの削除 **分析** + **GetAnalysis** – 分析の取得 + **CreateAnalysis** – 分析の作成 + **UpdateAnalysisAccess** – 分析アクセスの更新 + **UpdateAnalysis** – 分析の更新 + **RenameAnalysis** – 分析の名前変更 + **CreateVisual** – ビジュアルの作成 + **DeleteAnalysis** – ビジュアルの名前変更 + **DeleteVisual** – ビジュアルの削除 + **DeleteAnalysis** – 分析の削除 **データソース** + **CreateDataSource** – データソースの作成 + **FlatFile** – フラットファイル + **External** – 外部 + **S3** – S3 + **ImportS3ManifestFile** – S3 マニフェストファイル + **Presto** – Presto + **RDS** – RDS + **Redshift** – Redshift (手動) + **UpdateDataSource** – データソースの更新 + **DeleteDataSource** – データソースの削除 **データセット** + **CreateDataSet** – データセットの作成 + **CustomSQL** – カスタム SQL + **SQLTable** – SQL テーブル + **ファイル** – CSV または XLSX + **UpdateDataSet** – SQL 結合データセットの更新 + **UpdateDatasetAccess** – データセットアクセスの更新 + **DeleteDataSet** – データセットの削除 + **Querydatabase** – データセットの更新中にデータソースをクエリします。 ## 例: Amazon Quick Sight ログファイルエントリ 「トレイル」は、指定した Amazon S3 バケットにイベントをログファイルとして配信するように設定できます。CloudTrail のログファイルは、単一か複数のログエントリを含みます。イベントは、任意の出典からの単一のリクエストを表し、リクエストされたアクション、アクションの日時、リクエストパラメータなどに関する情報が含まれます。CloudTrail ログファイルは、パブリック API コールの順序付けられたスタックトレースではないため、特定の順序では表示されません。 次の例は、BatchCreateUser アクションを示す CloudTrail ログエントリです。 ``` { "eventVersion":"1.05", "userIdentity": { "type":"Root", "principalId":"123456789012", "arn":"arn:aws:iam::123456789012:root", "accountId":"123456789012", "userName":"test-username" }, "eventTime":"2017-04-19T03:16:13Z", "eventSource":"quicksight.amazonaws.com", "eventName":"BatchCreateUser", "awsRegion":"us-west-2", "requestParameters":null, "responseElements":null, "eventID":"e7d2382e-70a0-3fb7-9d41-a7a913422240", "readOnly":false, "eventType":"AwsServiceEvent", "recipientAccountId":"123456789012", "serviceEventDetails": { "eventRequestDetails": { "users": { "test-user-11": { "role":"USER" }, "test-user-22": { "role":"ADMIN" } } }, "eventResponseDetails": { "validUsers":[ ], "InvalidUsers":[ "test-user-11", "test-user-22" ] } } } ``` # CloudWatch を使用した Amazon Quick Sight のデータのモニタリング Amazon Quick は、Amazon Quick 環境の可用性とパフォーマンスをほぼリアルタイムで監視して対応するために使用できるメトリクスを Amazon CloudWatch に送信します。現在、Amazon Quick Sight ダッシュボード、ビジュアル、データセットの取り込み、非構造化データセット、クイックアクションコネクタのメトリクスをモニタリングして、Amazon Quick で一貫した高性能で中断のないエクスペリエンスを読者に提供できます。 CloudWatchとアラームの使用の詳細については、「[Amazon CloudWatch ユーザーガイド](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/WhatIsCloudWatch.html)」を参照してください。 ## Amazon CloudWatch でのクイックメトリクスへのアクセス Amazon CloudWatch で Amazon Quick メトリクスにアクセスするには、次の手順に従います。 **CloudWatch で Amazon Quick メトリクスにアクセスするには** 1. Amazon Quick アカウント AWS アカウント に関連付けられている にサインインします。 1. AWS マネジメントコンソール ホームページの左上隅で、**サービス**を選択し、**CloudWatch** を選択します。 1. ナビゲーションペインで、**[Metrics]** (メトリクス)、**[All metrics]** (すべてのメトリクス)、**[QuickSight]** の順に選択します。 **Topics** + [Amazon CloudWatch コンソールを使用したメトリクスグラフ](#cw-graph) + [Amazon CloudWatch コンソールを使用してアラームを作成する](#cw-alerts) + [メトリクス](#cw-metrics) + [メトリクス集約](#cw-aggregate-metrics) + [SPICE メトリクスの集約](#aggregate-spice-metrics) + [ディメンション](#cw-dimensions) ### Amazon CloudWatch コンソールを使用したメトリクスグラフ Amazon CloudWatch コンソールを使用して、Quick によって生成されたメトリクスデータをグラフ化することもできます。詳細については「*Amazon CloudWatch ユーザーガイド*」の「[メトリクスのグラフ化](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/graph_metrics.html)」を参照してください。 ### Amazon CloudWatch コンソールを使用してアラームを作成する Quick アセットの Amazon CloudWatch メトリクスをモニタリングする Amazon CloudWatch アラームを作成できます。指定したしきい値にメトリクスが到達すると、CloudWatch から自動的に通知が送信されます。例については、「Amazon CloudWatch ユーザーガイド」の「[Creating Amazon CloudWatch alarms](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)」(Amazon CloudWatch アラームの作成) を参照してください。 ### メトリクス `AWS/QuickSight` 名前空間には、Amazon Quick アセットのトラフィックとレイテンシーをモニタリングするための以下のメトリクスが含まれています。 **Topics** + [ダッシュボードごとのメトリクス](#per-dashboard-metrics) + [データセットごとの取り込みに関するメトリクス](#per-ingestion-metrics) + [ビジュアルごとのメトリクス](#per-visual-metrics) + [非構造化データセットごとのメトリクス](#per-unstructured-dataset-metrics) + [アクションごとのコネクタメトリクス](#per-action-connector-metrics) #### ダッシュボードごとのメトリクス 以下のメトリクスにより、ダッシュボードの表示回数と読み込み時間を追跡します。これらのメトリクスは、CloudWatch の `AWS/QuickSight/Dashboard Metrics` グループに保存されています。 | メトリクス | 説明 | ディメンション | Unit | | --- | --- | --- | --- | | DashboardViewCount | ダッシュボードが表示された回数。この数値には、ウェブ、モバイル、組み込みなどのすべてのアクセスパターンが含まれます。 このメトリクスに関して最も有用な統計は `SUM` です。これは、一定の期間内にダッシュボードが表示された回数の合計を表します。 | DashboardId | カウント | | DashboardViewLoadTime | Amazon Quick Sight ダッシュボードのロードにかかる時間。測定は、ユーザーが Amazon Quick Sight ダッシュボードに到達したときに開始され、ダッシュボードのすべてのビジュアルのレンダリングが終了したときに終了します。 このメトリクスの最も有用な統計は です。これは`AVERAGE`、一定期間中の Amazon Quick Sight ダッシュボードの平均ロード時間を表します。 | DashboardId | ミリ秒 | #### データセットごとの取り込みに関するメトリクス 次のメトリクスは、特定の [SPICE](https://docs.aws.amazon.com/quicksight/latest/user/spice.html) データセットの取り込みを追跡します。これらのメトリクスは、CloudWatch の `AWS/QuickSight/Ingestion Metrics` グループに保存されています。 | メトリクス | 説明 | ディメンション | Unit | | --- | --- | --- | --- | | IngestionErrorCount | 失敗した取り込みの数です。 このメトリクスに関して最も有用な統計は `SUM` です。これは、一定期間内に失敗した、取り込みの合計数を表します。 | DatasetId | カウント | | IngestionInvocationCount | 開始された取り込みの数です。これには、コンソールおよび Amazon Quick Sight API オペレーションを介して開始されるスケジュールされた取り込みと手動取り込みが含まれます。 このメトリクスに関して最も有用な統計は `SUM` です。これは、一定の期間内に開始された取り込みの合計数を表します。 | DatasetId | カウント | | IngestionLatency | 取り込みの開始から取り込みが完了するまでの時間間隔。 このメトリクスに関して最も有用な統計は `AVERAGE` です。これは、一定の期間内での取り込みの平均実行時間を表します。 | DatasetId | 秒 | | IngestionRowCount | 成功した行の取り込みの数。 このメトリクスに関して最も有用な統計は `SUM` です。これは、一定の期間内に取り込まれたデータの総量を表します。 | DatasetId | カウント | #### ビジュアルごとのメトリクス 次のメトリクスは、Amazon Quick Sight ダッシュボードの個々のビジュアルのロード時間とエラー数を追跡します。これらのメトリクスは、CloudWatch の `AWS/QuickSight/Visual Metrics` グループに保存されています。 | メトリクス | 説明 | ディメンション | Unit | | --- | --- | --- | --- | | VisualLoadTime | Amazon Quick Sight ビジュアルがビジュアルの最初のペイントに必要なクエリデータを受信するのにかかる時間。これには、クライアントから Amazon Quick Sight サービスへの往復クエリ時間、およびクライアントへの往復クエリ時間が含まれます。 このメトリクスに関して最も有用な統計は `AVERAGE` です。これは、一定の期間内において、ビジュアルのロードが必要とした時間の平均を表します。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | ミリ秒 | | VisualLoadErrorCount | Amazon Quick Sight ビジュアルが最初のペイントのデータクエリを完了できなかった回数。ビジュアルのロード中に発生したエラーの回数が、このメトリックスに含まれます。 このメトリクスに関して最も有用な統計は `SUM` です。これは、一定の期間内にビジュアルで発生した、ロードの失敗回数の合計を表します。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | カウント | #### 非構造化データセットごとのメトリクス 次のメトリクスは、Amazon Quick Sight の非構造化データセットのドキュメント統計とインデックス作成ステータスを追跡します。これらのメトリクスは、CloudWatch の `AWS/QuickSight/QuickInstanceId` グループに保存されています。 | メトリクス | 説明 | ディメンション | Unit | | --- | --- | --- | --- | | QuickIndexDocumentCount | 非構造化クイックインデックス内のドキュメントの数。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | カウント | | QuickIndexExtractedTextSize | 非構造化クイックインデックスの抽出されたテキストサイズ。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | バイト | | QuickIndexPurchasedInMB | 非構造化クイックインデックス用に購入したストレージの量。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | MB | | QuickIndexCapacityConsumedRawFileSizeInGB | 非構造化クイックインデックスによって消費される raw ファイルサイズ。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | GB | | QuickIndexCapacityRawFileSizeLimitInGB | 非構造化クイックインデックスの raw ファイルサイズ制限。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | GB | | DocumentsCrawled | 非構造化クイックインデックスでクロールされたアップロードされたドキュメントの数。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | カウント | | DocumentsIndexed | 非構造化クイックインデックスでインデックス化されたドキュメントの数。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | カウント | | DocumentsDeleted | 非構造化クイックインデックスから削除されたドキュメントの数。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | カウント | | DocumentsModified | 非構造化クイックインデックスで変更されたドキュメントの数。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | カウント | | DocumentsFailedToIndex | 非構造化クイックインデックスでインデックス作成に失敗したドキュメントの数。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | カウント | | ExtractedTextSize | 非構造化クイックインデックスのコネクタレベルの同期中に抽出されたテキストの合計サイズ。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | MB | #### アクションごとのコネクタメトリクス 次のメトリクスは、クイックアクションコネクタに対して行われた呼び出しの数を追跡します。これらのメトリクスは、CloudWatch `AWS/QuickSight`の名前空間にあります。 | メトリクス | 説明 | ディメンション | Unit | | --- | --- | --- | --- | | ActionInvocationCount | Action Connector が呼び出された回数。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | カウント | | ActionInvocationError | Action Connector が呼び出しに失敗した回数。 | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/quick/latest/userguide/monitoring-quicksight.html) | カウント | ### メトリクス集約 `AWS/QuickSight` 名前空間には、Amazon Quick アセットのトラフィックとレイテンシーをモニタリングするための以下の集計メトリクスが含まれています。 **Topics** + [ダッシュボードメトリクスを集計する](#aggregate-dashboard-metrics) + [取り込みの集計に関するメトリクス](#aggregate-ingestion-metrics) + [ビジュアルの集計に関するメトリクス](#aggregate-visual-metrics) + [非構造化データセットメトリクスを集約する](#aggregate-unstructured-dataset-metrics) + [アクションコネクタメトリクスを集約する](#aggregate-action-connector-metrics) #### ダッシュボードメトリクスを集計する 次のメトリクスは、Amazon Quick アカウントとリージョン内のすべてのダッシュボードのビュー数とロード時間を追跡します。これらのメトリクスは、CloudWatch の `AWS/QuickSight/Aggregate Metrics` グループに保存されています。 | メトリクス | 説明 | Unit | | --- | --- | --- | | DashboardViewCount | リージョン内の Amazon Quick アカウント全体ですべての Amazon Quick Sight ダッシュボードが表示された回数。この数には、ウェブ、モバイル、組み込みなど、すべてのアクセスパターンが集計されます。 このメトリクスで最も有用な統計は です。これは`SUM`、一定期間内の Amazon Quick Sight ダッシュボードビューの総数を表します。 | カウント | | DashboardViewLoadTime | すべての Amazon Quick Sight ダッシュボードのロードにかかる時間。測定は、ユーザーが Amazon Quick Sight ダッシュボードに移動したときに開始され、ダッシュボードのすべてのビジュアルのレンダリングが終了したときに終了します。 このメトリクスの最も有用な統計は です。これは`AVERAGE`、一定期間内のすべての Amazon Quick Sight ダッシュボードの平均ロード時間を表します。 | ミリ秒 | #### 取り込みの集計に関するメトリクス 次のメトリクスは、Amazon Quick アカウント および に関連付けられているすべての取り込みを追跡します AWS リージョン。これらのメトリクスは、CloudWatch の `AWS/QuickSight/Aggregate Metrics` グループに保存されています。 | メトリクス | 説明 | Unit | | --- | --- | --- | | IngestionErrorCount | 失敗した取り込みの数です。 このメトリクスに関して最も有用な統計は `SUM` です。これは、一定の期間内に失敗した、取り込みの合計数を表します。 | カウント | | IngestionInvocationCount | 開始された取り込みの数です。これには、コンソールおよび Amazon Quick Sight API オペレーションを介して開始されるスケジュールされた取り込みと手動取り込みが含まれます。 このメトリクスに関して最も有用な統計は `SUM` です。これは、一定の期間内に開始された取り込みの合計数を表します。 | カウント | | IngestionLatency | 取り込みの開始から取り込みが完了するまでの時間間隔。 このメトリクスに関して最も有用な統計は `AVERAGE` です。これは、一定の期間内での取り込みの平均実行時間を表します。 | 秒 | | IngestionRowCount | 成功した行の取り込みの数。 このメトリクスに関して最も有用な統計は `SUM` です。これは、一定の期間内に取り込まれたデータの総量を表します。 | カウント | #### ビジュアルの集計に関するメトリクス 次のメトリクスは、ダッシュボードとリージョンの Amazon Quick アカウントのすべてのビジュアルのロード時間とエラー数を追跡します。これらのメトリクスは、CloudWatch の `AWS/QuickSight/Aggregate Metrics` グループに保存されています。 | メトリクス | 説明 | Unit | | --- | --- | --- | | VisualLoadTime | すべての Amazon Quick Sight ビジュアルがビジュアルの最初のペイントに必要なクエリデータを受信するのにかかる時間。これには、クライアントから Amazon Quick サービス、クライアントへの往復クエリ時間が含まれます。 このメトリクスに関して最も有用な統計は `AVERAGE` です。これは、一定の期間内のすべての QuickSight ダッシュボードにおける平均ロード時間を表します。 | ミリ秒 | | VisualLoadErrorCount | Amazon Quick アカウントに属するすべての Amazon Quick Sight ビジュアルが、最初のペイントのデータクエリを完了できなかった回数。 このメトリクスに関して最も有用な統計は `SUM` です。これは、一定の期間内に失敗した、ビジュアルの合計数を表します。 | カウント | #### 非構造化データセットメトリクスを集約する 次のメトリクスは、リージョン内の Amazon Quick アカウント内のすべての非構造化データセットメトリクスを追跡します。これらのメトリクスは、CloudWatch の `AWS/QuickSight/Aggregate Metrics` グループに保存されています。 | メトリクス | 説明 | Unit | | --- | --- | --- | | QuickIndexDocumentCount | 非構造化クイックインデックス内のドキュメントの数。 このメトリクスで最も有用な統計は です。これは`SUM`、一定期間にインデックスに追加されたドキュメントの総数を表します。 | カウント | | QuickIndexExtractedTextSize | 非構造化クイックインデックスの抽出されたテキストサイズ。 このメトリクスで最も有用な統計は です。これは`SUM`、インデックス内のすべてのドキュメントのすべてのテキストの合計サイズを表します。 | バイト | | QuickIndexPurchasedInMB | 非構造化クイックインデックス用に購入したストレージの量。 このメトリクスで最も有用な統計は です。これは`SUM`、インデックス全体で購入したストレージの合計サイズを MB 単位で表します。 | MB | | QuickIndexCapacityConsumedRawFileSizeInGB | 非構造化クイックインデックスによって消費される raw ファイルサイズ。 このメトリクスで最も有用な統計は です。これは`SUM`、インデックス全体で消費された未加工ファイルの合計サイズを GB 単位で表します。 | GB | | QuickIndexCapacityRawFileSizeLimitInGB | 非構造化クイックインデックスの raw ファイルサイズ制限。 このメトリクスで最も有用な統計は です。これは`SUM`、インデックス全体の raw ファイルサイズ制限の合計を GB 単位で表します。 | GB | | DocumentsCrawled | 非構造化クイックインデックスでクロールされたアップロードされたドキュメントの数。 このメトリクスで最も有用な統計は です。これは`SUM`、インデックスでクロールされたドキュメントの総数を表します。 | カウント | | DocumentsIndexed | 非構造化クイックインデックスでインデックス化されたドキュメントの数。 このメトリクスの最も有用な統計は`SUM`、インデックスが作成されたドキュメントの総数を表す です。 | カウント | | DocumentsDeleted | 非構造化クイックインデックスから削除されたドキュメントの数。 このメトリクスで最も有用な統計は です。これは`SUM`、インデックスから削除されたドキュメントの総数を表します。 | カウント | | DocumentsModified | 非構造化クイックインデックスで変更されたドキュメントの数。 このメトリクスで最も有用な統計は です。これは`SUM`、インデックスで変更されたドキュメントの総数を表します。 | カウント | | DocumentsFailedToIndex | 非構造化クイックインデックスでインデックス作成に失敗したドキュメントの数。 このメトリクスで最も有用な統計は です。これは`SUM`、インデックス作成に失敗したドキュメントの総数を表します。 | カウント | | ExtractedTextSize | 非構造化クイックインデックスのコネクタレベルの同期中に抽出されたテキストの合計サイズ。 このメトリクスの最も有用な統計は です。これは`SUM`、コネクタレベルの同期中に抽出されたドキュメントの合計サイズを表します。 | MB | #### アクションコネクタメトリクスを集約する 次のメトリクスは、 AWS リージョンの Amazon Quick アカウントに関連付けられたすべてのクイックアクションコネクタの呼び出しを追跡します。これらのメトリクスは、CloudWatch の `AWS/QuickSight/Aggregate Metrics` グループに保存されています。 | メトリクス | 説明 | Unit | | --- | --- | --- | | ActionInvocationCount | 実行されたアクションコネクタの呼び出しの数。 このメトリクスで最も有用な統計は です。これは`SUM`、一定期間に開始されたアクションコネクタ呼び出しの総数を表します。 | カウント | | ActionInvocationError | 失敗したアクションコネクタの呼び出しの数。 このメトリクスで最も有用な統計は です。これは`SUM`、一定期間に失敗したアクションコネクタ呼び出しの総数を表します。 | カウント | ### SPICE メトリクスの集約 以下のメトリクスは SPICE 使用情報を監視し、取り込みが失敗する原因となる SPICE 使用量の上限に達するのを防ぐのに役立ちます。統計は最大 15 か月間保存されるため、履歴情報にアクセスして Amazon Quick アカウントの消費傾向をよりよく理解できます。これらのメトリクスは、CloudWatch の `AWS/QuickSight/Aggregate Metrics` グループに保存されています。 | メトリクス | 説明 | Unit | | --- | --- | --- | | SPICECapacityLimitInMB | この値は、特定の時点にプロビジョニングされた SPICE 容量を表します。このメトリクスは、使用容量または購入容量が 1 MB 以上変わると更新されます。 | Megabytes | | SPICECapacityConsumedInMB | これらの値は、特定の時点に消費された SPICE 容量を表します。このメトリクスは、使用容量または購入容量が 1 MB 以上変わると更新されます。 | Megabytes | ### ディメンション 以下は、Amazon CloudWatch に表示されるクイックメトリクスディメンションのリストです。 | ディメンション | 説明 | | --- | --- | | DashboardId | Amazon Quick Sight ダッシュボードのパブリック ID。 `ListDashboards` API オペレーションを使用して、Amazon Quick アカウント内のすべてのダッシュボードのリストを表示できます。詳細については、*Amazon Quick Sight API リファレンス*の[ListDashboards](https://docs.aws.amazon.com//quicksight/latest/developerguide/list-dashboards.html)」を参照してください。 | | DatasetId | Amazon Quick Sight データセットのパブリック ID。 `ListDataSets` API オペレーションを使用して、Amazon Quick Sight アカウント内のすべてのデータセットのリストを表示できます。詳細については、*Amazon Quick Sight API リファレンスの*[ListDataSets](https://docs.aws.amazon.com//quicksight/latest/developerguide/list-datasets.html)」を参照してください。 | | SheetId | Amazon Quick Sight シートのパブリック ID。 | | VisualId | Amazon Quick Sight ビジュアルのパブリック ID。 | | KnowledgeBaseId | Amazon Quick Sight ナレッジベースのパブリック ID。 | | QuickInstanceId | クイックインスタンスのパブリック ID。 | | ActionConnectorId | クイックアクションコネクタのパブリック ID。 | | ActionConnectorType | クイックアクションコネクタのタイプ。 | | ActionId | クイックアクションのパブリック ID。 | | InvokeErrorCode | 失敗したクイックアクションコネクタの呼び出しに関連するエラーコード。 |