AWS SQS(Simple Queue Service)¶
AWS Simple Queue Service(SQS)の表示メトリクスには、キュー内で最も古い未削除メッセージのおおよその経過時間、遅延していてすぐに読み取れないメッセージ数、処理中のメッセージ数、キューから取得できるメッセージ数などがあります。
設定¶
Func のインストール¶
Guance のインテグレーション - 拡張機能 - ホステッド Func の有効化を推奨します。前提条件はすべて自動的にインストールされるため、そのままスクリプトのインストールに進んでください。
Func を自前でデプロイする場合はFunc の自前デプロイを参照してください
スクリプトのインストール¶
ヒント: 要件を満たす Amazon AK を事前に用意してください(簡単にするため、グローバルの読み取り専用権限
ReadOnlyAccessを直接付与しても構いません)
マネージド版の有効化スクリプト¶
- Guance コンソールにログインします
- 【インテグレーション】メニューをクリックし、【クラウドアカウント管理】を選択します。
- [クラウドアカウントを追加] をクリックし、[AWS] を選択して画面に必要な情報を入力します。以前にクラウドアカウント情報を設定済みの場合は、この手順をスキップしてください
- [テスト] をクリックし、成功したら [保存] をクリックします。失敗した場合は、関連設定が正しいか確認して再度テストしてください
- 【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページに入ります
- クラウドアカウントの詳細ページで【インテグレーション】をクリックし、
未インストール一覧からAWS SQS(Simple Queue Service)を探して【インストール】をクリックします。
手動有効化スクリプト¶
-
Func コンソールにログインし、【スクリプトマーケット】から Guance のスクリプトマーケットを開いて、
integration_aws_sqsを検索します。 -
[インストール] をクリックし、対応するパラメータとして AWS AK ID、AK Secret、アカウント名を入力します
-
【起動スクリプトをデプロイ】をクリックします。システムが
Startupスクリプトセットを作成し、対応する起動スクリプトを自動設定します。 -
有効化後、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。[実行] をクリックすると、定期実行を待たずにすぐ 1 回実行できます。少し待ってから、実行タスクの記録と対応するログを確認してください
検証¶
- [管理 / 自動トリガー設定]で、対象タスクの自動トリガー設定が存在することを確認し、タスク履歴とログに異常がないか確認します。
- Guance の「インフラストラクチャ / カスタム」で資産情報が存在するか確認します
- Guance の「メトリクス」で対応する監視データがあるか確認します
メトリクス¶
Amazon CloudWatch の監視を設定すると、デフォルトのメトリクスセットは次のとおりです。設定により、さらに多くのメトリクスを収集できます。
AWS SQS(Simple Queue Service) のメトリクス詳細
| メトリクス名 | 説明 | 単位 | 有効な統計データ |
|---|---|---|---|
ApproximateAgeOfOldestMessage |
キュー内で最も古い未削除メッセージのおおよその経過時間です。注意: メッセージを 3 回(またはそれ以上)受信しても処理されない場合、そのメッセージはキューの末尾へ移動し、ApproximateAgeOfOldestMessage メトリクスは、3 回以上受信されていない 2 番目に古いメッセージを示します。再ドライブポリシーがあるキューでも、この動作は発生します。単一の毒メッセージ(何度も受信されるが一度も削除されないメッセージ)がこのメトリクスを歪めるため、毒メッセージが正常に使用されるまでは、その経過時間はメトリクスに含まれません。キューに再ドライブポリシーがある場合、設定された最大受信回数に達するとメッセージは DLQ に移動します。メッセージが DLQ に移動すると、DLQ の ApproximateAgeOfOldestMessage メトリクスは、そのメッセージが DLQ に移動した時点を示します(元の送信時刻ではありません)。報告基準: キューがアクティブであれば、非負の値を報告します。 | 秒 | 平均値、最小値、最大値、合計、データサンプル(Amazon SQS コンソールではサンプル数として表示されます) |
ApproximateNumberOfMessagesDelayed |
キュー内の遅延メッセージ数です。これらはすぐには読み取れません。キューが遅延キューとして設定されている場合、または遅延パラメータを使ってメッセージを送信した場合に発生します。報告基準: キューがアクティブであれば、非負の値を報告します。 | 件数 | 平均値、最小値、最大値、合計、データサンプル(Amazon SQS コンソールではサンプル数として表示されます) |
ApproximateNumberOfMessagesNotVisible |
処理中のメッセージ数です。メッセージがクライアントに送信済みで、まだ削除されていないか、可視性ウィンドウの終了時点にまだ達していない場合、そのメッセージは処理中と見なされます。報告基準: キューがアクティブであれば、非負の値を報告します。 | 件数 | 平均値、最小値、最大値、合計、データサンプル(Amazon SQS コンソールではサンプル数として表示されます) |
ApproximateNumberOfMessagesVisible |
キューから取得できるメッセージ数です。報告基準: キューがアクティブであれば、非負の値を報告します。 | 件数 | 平均値、最小値、最大値、合計、データサンプル(Amazon SQS コンソールではサンプル数として表示されます) |
NumberOfEmptyReceives |
メッセージを返さなかった ReceiveMessage API 呼び出し数です。報告基準: キューがアクティブであれば、非負の値を報告します。 | 件数 | 平均値、最小値、最大値、合計、データサンプル(Amazon SQS コンソールではサンプル数として表示されます) |
NumberOfMessagesDeleted |
キューから削除されたメッセージ数です。報告基準: キューがアクティブであれば、非負の値を報告します。 | 件数 | 平均値、最小値、最大値、合計、データサンプル(Amazon SQS コンソールではサンプル数として表示されます) |
NumberOfMessagesReceived |
ReceiveMessage 操作の呼び出しで返されたメッセージ数です。報告基準: キューがアクティブであれば、非負の値を報告します。 | 件数 | 平均値、最小値、最大値、合計、データサンプル(Amazon SQS コンソールではサンプル数として表示されます) |
NumberOfMessagesSent |
キューに追加されたメッセージ数です。報告基準: キューがアクティブであれば、非負の値を報告します。 | 件数 | 平均値、最小値、最大値、合計、データサンプル(Amazon SQS コンソールではサンプル数として表示されます) |
SentMessageSize |
キューに追加されたメッセージサイズです。報告基準: キューがアクティブであれば、非負の値を報告します。 | バイト | 平均値、最小値、最大値、合計、データサンプル(Amazon SQS コンソールではサンプル数として表示されます) |