AWS ELB¶

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

設定¶

Func のインストール¶

Guance連携 - 拡張 - ホスト版 Func の有効化を推奨します。必要な前提条件はすべて自動でインストールされますので、そのままスクリプトをインストールしてください。

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

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

ヒント: 要件を満たす Amazon AK を事前に準備してください（手短に済ませるなら、グローバル読み取り専用権限 ReadOnlyAccess を直接付与してかまいません）

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

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

手動でのスクリプト有効化¶

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

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

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

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

検証¶

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

メトリクス¶

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

Amazon CloudWatch Application Load Balancer メトリクス詳細

Amazon CloudWatch Network Load Balancer メトリクス詳細

Amazon CloudWatch Gateway Load Balancer メトリクス詳細

Amazon CloudWatch Classic Load Balancer メトリクス詳細

Application Load Balancer のメトリクス¶

AWS/ApplicationELB 名前空間には、ターゲットの以下のメトリクスが含まれます。

AWS/ApplicationELB 名前空間には、ターゲットグループのヘルスに関する以下のメトリクスが含まれます。詳細はターゲットグループのヘルスを参照してください。

AWS/ApplicationELB 名前空間には、登録済みターゲットが Lambda 関数である場合の以下のメトリクスが含まれます。

AWS/ApplicationELB 名前空間には、ユーザー認証に関する以下のメトリクスが含まれます。

Network Load Balancer のメトリクス¶

Gateway Load Balancer のメトリクス¶

Classic Load Balancer のメトリクス¶

ロードバランサーのメトリクスディメンション¶

Application / Network / Gateway ロードバランサーのメトリクスを絞り込むには、次のディメンションを使用します。

Classic ロードバランサーのメトリクスを絞り込むには、次のディメンションを使用します。

ログ¶

ELB ログには直接公開された収集方法がありません。まずログを S3 バケットに保存し、その後 Lambda でログデータを取得してプラットフォームへ報告します。

Application ELB のログ有効化¶

1. 対象のロードバランサーを選択して詳細ページに入ります
2. 詳細ページで「操作」をクリックし、「ロードバランサー属性を編集」を選択します
3. 「監視」カテゴリで「アクセスログ」を有効にし、対応する S3 バケットを選択します。
4. 保存します

Lambda の設定¶

参照：Lambda による S3 ログデータの取得

ログパイプライン¶

grok(_, "%{NOTSPACE:protocal} %{TIMESTAMP_ISO8601:timestamp} %{NOTSPACE:LoadBalancer} %{IP:client}:%{POSINT:client_port} %{IP:target}:%{POSINT:target_port} %{NUMBER:request_processing_time} %{NUMBER:target_processing_time} %{NUMBER:response_processing_time} %{NUMBER:elb_status_code} %{NUMBER:target_status_code} %{NUMBER:received_bytes} %{NUMBER:sent_bytes} \"%{NOTSPACE:http_method} %{NOTSPACE:uri} HTTP/%{NUMBER:http_version}\" \"%{DATA:user_agent}\" %{NOTSPACE:ssl_cipher} %{NOTSPACE:ssl_protocol} %{NOTSPACE:target_group_arn} \"%{NOTSPACE:x_amzn_trace_id}\" \"%{DATA:domain_name}\" \"%{DATA:chosen_cert_arn}\" %{NUMBER:matched_rule_priority} %{TIMESTAMP_ISO8601:request_creation_time} \"%{WORD:actions_executed}\" \"%{DATA:redirect_url}\" \"%{DATA:error_reason}\" \"%{IP:target_host}:%{POSINT:target_host_port_list}\" \"%{NUMBER:target_status_code_list}\" \"%{DATA:classification}\" \"%{DATA:classification_reason}\" %{NOTSPACE:conn_trace_id}")

status = "info"

cast(elb_status_code,"int")

if elb_status_code >=400 {
  status = "error"
}

add_key("aws_log_type","access_log")
add_key(status,status)
aws_json=load_json(aws)

lambda_func_data = aws_json["invoked_function_arn"]

add_key(s3_bucket,aws_json["s3"]["bucket"])

grok(lambda_func_data, "arn:aws:lambda:%{DATA:region}:%{NUMBER:account_id}:function:%{NOTSPACE:lambda_func}")

オブジェクト¶

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

{
  "measurement": "aws_aelb",
  "tags": {
    "name"                 : "app/openway/8e8d762xxxxxx",
    "RegionId"             : "cn-northwest-1",
    "LoadBalancerArn"      : "arn:aws-cn:elasticloadbalancing:cn-northwest-1:588271xxxxx:loadbalancer/app/openway/8e8d762xxxxxx",
    "State"                : "active",
    "Type"                 : "application",
    "VpcId"                : "vpc-2exxxxx",
    "Scheme"               : "internet-facing",
    "DNSName"              : "openway-203509xxxx.cn-northwest-1.elb.amazonaws.com.cn",
    "LoadBalancerName"     : "openway",
    "CanonicalHostedZoneId": "ZM7IZAIxxxxxx"
  },
  "fields": {
    "CreatedTime"         : "2022-03-09T06:13:31Z",
    "ListenerDescriptions": "{JSON データ}",
    "AvailabilityZones"   : "{アベイラビリティゾーンの JSON データ}",
    "message"             : "{インスタンスの JSON データ}"
  }
}

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

ヒント 1: AWS ELB のメトリクスセットは、ロードバランサーの種類ごとに 4 つに分かれます：

1. Application ELB に対応するメトリクスセットは aws_aelb
2. Network ELB に対応するメトリクスセットは aws_nelb
3. Gateway ELB に対応するメトリクスセットは aws_gelb
4. Classic ELB に対応するメトリクスセットは aws_elb

ヒント 2: tags.name の値の取り方は 2 通りあります：

1. Classic Load Balancers では LoadBalancerName フィールドを使用します。
2. Application、Network、Gateway の 3 種類の Load Balancers では、ロードバランサー ARN（LoadBalancerArn）の末尾部分を切り出します。

Network Load Balancer の例：

`LoadBalancerArn`は`arn:awS-cn:elasticloadbalancing:cn-northwest-1:xxxx1335135:loadbalancer/net/k8s-forethou-kodongin-xxxxa46f01/xxxxe75ae81d08c2`

対応するtags.nameはnet/k8s-forethou-kodongin-xxxxa46f01/xxxxe75ae81d08c2です

ヒント 3:

• fields.message、tags.AvailabilityZones は JSON シリアライズ後の文字列です
• tags.state フィールドは Load Balancers の状態を表し、値は active、provisioning、active_impaired、failed です（"classic" タイプのロードバランサーインスタンスにはこのフィールドはありません）
• tags.Type フィールドは Load Balancers の種類を表し、値は application、network、gateway、classic です
• tags.Scheme フィールドは Load Balancers のモードを表し、値は internet-facing、internal です
• fields.ListenerDescriptions フィールドは、このロードバランサーのリスナー一覧です
• fields.AvailabilityZones フィールドは、ロードバランサーに関連付けられた Amazon Route 53 のアベイラビリティゾーン情報を表します