AWS Kinesis¶
スクリプトマーケットの「Guanceクラウド同期」シリーズのスクリプトパッケージを使用して、クラウド監視とクラウド資産のデータをGuanceに同期します
設定¶
Func のインストール¶
Guance の「統合 - 拡張 - マネージド版 Func」の利用を推奨します。前提条件はすべて自動でインストールされるので、そのままスクリプトのインストールを続けてください
Func を自前でデプロイする場合はFunc を自前でデプロイ を参照してください
スクリプトのインストール¶
ヒント:要件を満たす Amazon の AK を事前に用意してください(簡単のため、グローバルな読み取り専用権限
ReadOnlyAccessを直接付与して構いません)
マネージド版のスクリプト有効化¶
- Guance コンソールにログインします
- 【統合】メニューをクリックし、【クラウドアカウント管理】を選択します
- 【クラウドアカウントの追加】をクリックし、【AWS】を選択して画面に必要な情報を入力します。すでにクラウドアカウント情報を設定済みの場合は、この手順を省略します
- 【テスト】をクリックし、テストに成功したら【保存】をクリックします。失敗した場合は関連設定が正しいか確認し、再度テストしてください
- 【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページに入ります
- クラウドアカウント詳細ページの【統合】ボタンをクリックし、
未インストール一覧でAWS Kinesisを見つけて【インストール】をクリックし、表示されるインストール画面でそのままインストールします。
手動でスクリプトを有効化¶
-
Func コンソールにログインし、【スクリプトマーケット】をクリックして Guance のスクリプトマーケットに入り、
integration_aws_kinesisを検索します -
【インストール】をクリックし、対応するパラメータとして AWS AK ID、AK Secret、アカウント名を入力します。
-
【起動スクリプトをデプロイ】をクリックすると、システムが自動で
Startupスクリプトセットを作成し、対応する起動スクリプトを自動設定します。 -
有効化後は「管理 / 自動トリガー設定」で該当の自動トリガー設定を確認できます。【実行】をクリックすると、定期実行を待たずにすぐ 1 回実行されます。しばらくしてから、実行タスクの履歴と対応するログを確認できます。
確認¶
- 「管理 / 自動トリガー設定」で、該当タスクに対応する自動トリガー設定が存在するか確認し、あわせてタスク履歴とログを見て異常がないか確認します
- Guance の「インフラストラクチャ / カスタム」で資産情報が存在するか確認します
- Guance の「メトリクス」で対応する監視データがあるか確認します
メトリクス¶
Amazon CloudWatch を設定すると、デフォルトのメトリクスセットは次のとおりです。設定により、さらに多くのメトリクスを収集できます Amazon CloudWatch のメトリクス詳細
インスタンスメトリクス¶
AWS/Kinesis 名前空間には、以下のインスタンスメトリクスが含まれます。
| メトリクス | 説明 |
|---|---|
IncomingBytes |
指定期間内に Kinesis ストリームへ正常に送信されたバイト数です。このメトリクスには、PutRecord と PutRecords によるバイト数が含まれます。統計データ Minimum、Maximum、Average は、指定期間内のストリームの単一 put 操作におけるバイト数を表します。シャードレベルのメトリクス名: IncomingBytes。ディメンション: StreamName。単位: バイト |
IncomingRecords |
指定期間内に Kinesis ストリームへ正常に送信されたレコード数です。このメトリクスには、PutRecord と PutRecords によるレコード数が含まれます。統計データ Minimum、Maximum、Average は、指定期間内のストリームの単一 put 操作におけるレコード数を表します。シャードレベルのメトリクス名: IncomingRecords。ディメンション: StreamName。単位: 件数 |
WriteProvisionedThroughputExceeded |
指定期間内にストリームの制限により拒否されたレコード数です。このメトリクスには、PutRecord と PutRecords の制限が含まれます。このメトリクスで最もよく使われる統計データは Average です。統計データ Minimum の値が 0 でない場合、ストリームのレコードは指定期間内に制限されます。統計データ Maximum の値が 0 の場合、ストリームのいずれのレコードも指定期間内に制限されません。シャードレベルのメトリクス名: WriteProvisionedThroughputExceeded。ディメンション: StreamName。単位: 件数 |
PutRecords.Bytes |
指定期間内の PutRecords 操作で Kinesis ストリームに送信されたバイト数です。ディメンション: StreamName。単位: バイト |
PutRecords.Success |
指定期間内に測定された各 Kinesis ストリームの PutRecords 操作のうち、少なくとも 1 件のレコードが成功した回数です。ディメンション: StreamName。単位: 件数 |
PutRecords.Latency |
指定期間内に測定された各 PutRecords 操作にかかった時間です。ディメンション: StreamName.単位: ミリ秒 |
PutRecords.FailedRecords |
内部エラーにより拒否されたレコード数です。指定期間内に測定された各 Kinesis データストリームの PutRecords 操作の件数です。まれに内部エラーが発生するため、再試行する必要があります。ディメンション: StreamName.単位: 件数 |
PutRecords.ThrottledRecords |
制限があるために拒否されたレコード数です。指定期間内に測定された各 Kinesis データストリームの PutRecords 操作の件数です。ディメンション: StreamName.単位: 件数 |
utRecords.TotalRecords |
指定期間内に測定された各 Kinesis データストリームの PutRecords 操作の総レコード数です。ディメンション: StreamName.単位: 件数 |
| ## オブジェクト |
収集された AWS Kinesis オブジェクトのデータ構造です。「インフラストラクチャ - カスタム」でオブジェクトデータを確認できます
{
"measurement": "aws_kinesis",
"tags": {
"class" : "aws_kinesis",
"cloud_provider" : "aws",
"create_time" : "2023/08/07 14:29:19",
"date" : "2023/08/07 14:29:19",
"date_ns" :"0",
"EncryptionType" :"NONE",
"HasMoreShards" :"false",
"name" :"zsh_test",
"RegionId" :"cn-northwest-1",
"RetentionPeriodHours":"24",
"StreamARN":"arn:aws-cn:kinesis:cn-northwest-1:294654068288:stream/zsh_test",
"StreamName":"zsh_test",
"StreamStatus":"ACTIVE"
}
}
注意:
tags内のフィールドは今後の更新で変更される可能性がありますヒント1:
nameの値はインスタンス名であり、一意識別子として使用します