AWS シンプルキューサービス¶
AWS Simple Queue Service(SQS)の表示メトリクスには、キュー内で最も古い未削除メッセージのおおよその経過時間、遅延していてすぐに読み取れないメッセージ数、処理中のメッセージ数、キューから取得できるメッセージ数などがあります。
設定¶
Func のインストール¶
Guanceの統合 - 拡張 - マネージド版 Func を有効化することを推奨します。前提条件はすべて自動でインストールされるため、そのままスクリプトのインストールに進んでください。
Func を自前でデプロイする場合はFunc を自前でデプロイを参照してください。
インストールスクリプト¶
ヒント:要件を満たす Amazon の AK をあらかじめ用意してください。簡単のため、グローバル読み取り専用権限
ReadOnlyAccessを直接付与しても構いません。
マネージド版の有効化スクリプト¶
- Guance コンソールにログインします。
- 【統合】メニューをクリックし、【クラウドアカウント管理】を選択します。
- 【クラウドアカウントを追加】をクリックし、【AWS】を選択して画面に必要な情報を入力します。すでにクラウドアカウント情報が設定済みの場合は、この手順をスキップしてください。
- 【テスト】をクリックし、テスト成功後に【保存】をクリックします。テストに失敗した場合は、関連する設定が正しいか確認してから再度テストしてください。
- 【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページを開きます。
- クラウドアカウント詳細ページの【統合】ボタンをクリックし、
未インストール一覧からAWS Simple Queue Serviceを見つけて【インストール】ボタンをクリックすると、表示されるインストール画面からそのままインストールできます。
手動有効化スクリプト¶
-
Func コンソールにログインし、【スクリプトマーケット】をクリックして Guance スクリプトマーケットに入り、
integration_aws_sqsを検索します。 -
【インストール】をクリックしたあと、AWS AK ID、AK Secret、アカウント名を入力します。
-
【起動スクリプトをデプロイ】をクリックすると、システムが自動的に
Startupスクリプトセットを作成し、対応する起動スクリプトを自動で設定します。 -
有効化後は、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。【実行】をクリックすると、定期実行を待たずにすぐ 1 回実行できます。しばらくしてから、実行タスクの記録と対応するログを確認してください。
検証¶
- 「管理 / 自動トリガー設定」で、対応するタスクに対応する自動トリガー設定が存在するか確認し、あわせてタスク記録とログを確認して異常がないかチェックします。
- Guance の「インフラストラクチャ / カスタム」で資産情報が存在するか確認します。
- Guance の「メトリクス」で対応する監視データがあるか確認します。
メトリクス¶
Amazon のクラウド監視を設定すると、デフォルトのメトリクスセットは次のとおりです。設定によって、さらに多くのメトリクスを収集できます。
Amazon CloudWatch の AWS 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 コンソールではサンプル数として表示されます) |