AWS ElastiCache Redis¶

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

設定¶

Func のインストール¶

Guance インテグレーション - 拡張 - ホスティング版 Func の利用を推奨します。前提条件はすべて自動でインストールされるので、そのままスクリプトのインストールを続けてください。

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

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

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

ホスティング版でスクリプトを有効化する場合¶

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

手動でスクリプトを有効化する場合¶

Func コンソールにログインし、【スクリプトマーケット】をクリックして Guance スクリプトマーケットに入り、integration_aws_elasticache を検索します
【インストール】をクリックし、必要なパラメータ AWS AK ID、AK Secret、アカウント名を入力します。
【デプロイしてスクリプトを起動】をクリックすると、システムが自動的に Startup スクリプトセットを作成し、対応する起動スクリプトを自動で設定します。
有効化後は、「管理 / 自動トリガー設定」で対応する自動トリガー設定を確認できます。【実行】をクリックすると、定期実行を待たずにすぐ 1 回実行できます。しばらくしてから、実行タスクの記録と対応するログを確認できます。

検証¶

「管理 / 自動トリガー設定」で、対応するタスクに自動トリガー設定が存在するか確認し、あわせてタスク記録とログを見て異常がないか確認します
Guance の「インフラ / カスタム」で資産情報が存在するか確認します
Guance の「メトリクス」で対応する監視データがあるか確認します

メトリクス¶

Amazon CloudWatch を正しく設定すると、デフォルトのメトリクスセットは次のとおりです。設定により、さらに多くのメトリクスを収集できます Amazon CloudWatch メトリクスの詳細

ホストレベルのメトリクス¶

メトリクス名	説明	単位	ディメンション
CPUUtilization	ホスト全体の CPU 使用率の割合	%	name
FreeableMemory	ホスト上で利用可能な空きメモリ量。これは、OS が空きとして報告する RAM、バッファ、キャッシュから導出されます。	byte	name
SwapUsage	ホスト上のスワップ使用量。	byte	name
NetworkBytesIn	ホストがネットワークから読み取ったバイト数。	byte	name
NetworkBytesOut	インスタンスがすべてのネットワークインターフェイスで送信したバイト数。	byte	name
NetworkPacketsIn	インスタンスがすべてのネットワークインターフェイスで受信したパケット数。このメトリクスは、単一インスタンス上のパケット数に基づいて受信トラフィック量を示します。	count	name
NetworkPacketsOut	インスタンスがすべてのネットワークインターフェイスで送信したパケット数。このメトリクスは、単一インスタンス上のパケット数に基づいて送信トラフィック量を示します。	count	name

Redis のメトリクス¶

メトリクス名	説明	単位	ディメンション
`ActiveDefragHits`	アクティブデフラグプロセスが 1 分あたりに実行した値の再割り当て数。	count	name
`BytesUsedForCache`	メモリ内でキャッシュに使用されている総バイト数。	byte	name
`CacheHits`	主辞書で成功した読み取り専用キー検索回数。	count	name
`CacheMisses`	主辞書で失敗した読み取り専用キー検索回数。	count	name
`CurrConnections`	読み取り専用レプリカからの接続を除いたクライアント接続数。	count	name
`CurrItems`	キャッシュ内のアイテム数。	count	name
`CurrVolatileItems`	すべてのデータベースにおける ttl が設定されたキーの総数。	count	name
`DatabaseCapacityUsagePercentage`	クラスターの総データ容量に対して使用中の割合。	%	name
`DatabaseMemoryUsagePercentage`	クラスターで使用中のメモリの割合。	%	name
`EngineCPUUtilization`	Redis エンジンのスレッドに割り当てられた CPU 使用率。	%	name
`Evictions`	`maxmemory` 制限により追い出されたキー数。	count	name
`IsMaster`	ノードが現在のシャード/クラスターのマスターノードかどうかを示します。メトリクス値は 0（マスターではない）または 1（マスター）です。	count	name
`MasterLinkHealthStatus`	この状態には 0 または 1 の 2 つの値があります。0 は Elasticache マスターノードのデータが EC2 上の Redis と同期されていないことを示します。1 はデータが同期済みであることを示します。	count	name
`MemoryFragmentationRatio`	Redis エンジンのメモリ割り当て効率を示します。	count	name

オブジェクト¶

収集された Amazon AWS ElastiCache Redis オブジェクトのデータ構造です。「インフラ - カスタム」でオブジェクトデータを確認できます

{
  "measurement": "aws_elasticache",
  "tags": {
    "name"                     : "test",
    "CacheClusterId"           : "test",
    "CacheNodeType"            : "cache.t3.small",
    "Engine"                   : "redis",
    "EngineVersion"            : "6.2.5",
    "CacheClusterStatus"       : " available",
    "PreferredAvailabilityZone": "cn-northwest-1b",
    "ARN"                      : "arn:aws-cn:elasticache:cn-northwest-1:5881335135:cluster:test",
    "RegionId"                 : "cn-north-1"
  },
  "fields": {
    "SecurityGroups": "{セキュリティグループ JSON データ}}",
    "NumCacheNodes" : "1",
    "message"       : "{インスタンス JSON データ}"
  }
}

注意：tags、fields 内のフィールドは今後の更新で変更される可能性があります

ヒント 1：tags.name の値はインスタンス ID であり、一意識別子として使用されます

ヒント 2：fields.message、fields.network_interfaces、fields.blockdevicemappings は JSON シリアライズ後の文字列です