コンテンツにスキップ

AWS Kinesis

スクリプトマーケットの「Guanceクラウド同期」シリーズのスクリプトパッケージを使用して、クラウド監視とクラウド資産のデータをGuanceに同期します

設定

Func のインストール

Guance の「統合 - 拡張 - マネージド版 Func」の利用を推奨します。前提条件はすべて自動でインストールされるので、そのままスクリプトのインストールを続けてください

Func を自前でデプロイする場合はFunc を自前でデプロイ を参照してください

スクリプトのインストール

ヒント:要件を満たす Amazon の AK を事前に用意してください(簡単のため、グローバルな読み取り専用権限 ReadOnlyAccess を直接付与して構いません)

マネージド版のスクリプト有効化

  1. Guance コンソールにログインします
  2. 【統合】メニューをクリックし、【クラウドアカウント管理】を選択します
  3. 【クラウドアカウントの追加】をクリックし、【AWS】を選択して画面に必要な情報を入力します。すでにクラウドアカウント情報を設定済みの場合は、この手順を省略します
  4. 【テスト】をクリックし、テストに成功したら【保存】をクリックします。失敗した場合は関連設定が正しいか確認し、再度テストしてください
  5. 【クラウドアカウント管理】の一覧で追加済みのクラウドアカウントを確認できます。該当するクラウドアカウントをクリックして詳細ページに入ります
  6. クラウドアカウント詳細ページの【統合】ボタンをクリックし、未インストール 一覧で AWS Kinesis を見つけて【インストール】をクリックし、表示されるインストール画面でそのままインストールします。

手動でスクリプトを有効化

  1. Func コンソールにログインし、【スクリプトマーケット】をクリックして Guance のスクリプトマーケットに入り、integration_aws_kinesis を検索します

  2. 【インストール】をクリックし、対応するパラメータとして AWS AK ID、AK Secret、アカウント名を入力します。

  3. 【起動スクリプトをデプロイ】をクリックすると、システムが自動で Startup スクリプトセットを作成し、対応する起動スクリプトを自動設定します。

  4. 有効化後は「管理 / 自動トリガー設定」で該当の自動トリガー設定を確認できます。【実行】をクリックすると、定期実行を待たずにすぐ 1 回実行されます。しばらくしてから、実行タスクの履歴と対応するログを確認できます。

確認

  1. 「管理 / 自動トリガー設定」で、該当タスクに対応する自動トリガー設定が存在するか確認し、あわせてタスク履歴とログを見て異常がないか確認します
  2. Guance の「インフラストラクチャ / カスタム」で資産情報が存在するか確認します
  3. 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 の値はインスタンス名であり、一意識別子として使用します

フィードバック

このページは役に立ちましたか?