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. 「관리 / 자동 트리거 구성」에서 해당 작업의 자동 트리거 구성이 존재하는지 확인하고, 작업 기록 및 로그를 함께 확인해 이상이 있는지 점검합니다.
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 로그 데이터를 가져오기

로그 Pipeline¶

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 지표 집합은 로드 밸런서 유형에 따라 네 가지로 나뉩니다:

1. Application ELB에 해당하는 지표 집합은 aws_aelb
2. Network ELB에 해당하는 지표 집합은 aws_nelb
3. Gateway ELB에 해당하는 지표 집합은 aws_gelb
4. Classic ELB에 해당하는 지표 집합은 aws_elb

팁 2: tags.name 값은 두 가지 방식으로 나뉩니다:

1. Classic Load Balancers는 LoadBalancerName 필드를 사용합니다.
2. Application, Network, Gateway 세 유형의 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 가용 영역 정보를 나타냅니다.