AWS EFS

AWS Elastic File System のメトリクスデータを収集する

設定¶

Func のインストール¶

Guance の「統合 - 拡張 - ホスト型 Func」を有効にすることを推奨します。前提条件はすべて自動でインストールされるため、続けてスクリプトをインストールしてください。

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

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

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

ホスト型の有効化スクリプト¶

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

手動有効化スクリプト¶

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

検証¶

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

メトリクス¶

Amazon CloudWatch を設定することで、設定によってさらに多くのメトリクスを収集できます Amazon CloudWatch メトリクスの詳細

AWS Elastic File System のメトリクスは aws_AWS/EFS メトリクスセットにあり、説明列には各メトリクスの説明と単位、および統計データが含まれます。

メトリクス	説明	単位
`ClientConnections`	ファイルシステムへのクライアント接続数	件数
`DataReadIOBytes`	各ファイルシステムの読み取り操作における実際のバイト数	Bytes
`DataWriteIOBytes`	各ファイルシステムの書き込み操作における実際のバイト数	Bytes
`MetadataIOBytes`	各メタデータ操作における実際のバイト数	Bytes
`MetadataReadIOBytes`	各メタデータ読み取りにおける実際のバイト数	Bytes
`MetadataWriteIOBytes`	各メタデータ書き込みにおける実際のバイト数	Bytes
`MeteredIOBytes`	各ファイルシステム操作の計測済みバイト数	Bytes
`PercentIOLimit`	ファイルシステムが汎用パフォーマンスモードの I/O 制限にどの程度近づいているかを示します	%
`PermittedThroughput`	ファイルシステムが駆動可能な最大スループット	Bytes/s
`TotalIOBytes`	I/O 操作で転送されたバイト数	Bytes

オブジェクト¶

収集された AWS Elastic File System のオブジェクトデータ構造です。「インフラストラクチャ - リソースディレクトリ」でオブジェクトデータを確認できます

{
  "measurement": "aws_efs",
  "tags": {
    "OwnerId"                    : "876267738xxxx",
    "FileSystemId"               : "fs-03babd100fxxxxxxx",
    "FileSystemArn"              : "arn:aws:elasticfilesystem:ap-southeast-1:876267738534:file-system/fs-xxx",
    "LifeCycleState"             : "available",
    "PerformanceMode"            : "generalPurpose",
    "KmsKeyId"                   : "arn:aws:kms:ap-southeast-1:876267738534:key/0dd81bcb-d916xxxxx",
    "ThroughputMode"             : "elastic",
    "AvailabilityZoneName"       : "xxxxxxx",
    "AvailabilityZoneId"         : "xxxxxxx",
    "State"                      : "xxxxxxx"

  },
  "fields": {
    "NumberOfMountTargets"                    : "3",
    "CreationTime"                            : "2025/07/18 17:23:04",
    "Encrypted"                               : "True",
    "ProvisionedThroughputInMibps"            : "xxxxxx"
  }
}

注意: tags、fields の中のフィールドは、今後の更新により変更される場合があります