기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS 관리형 컬렉터 사용
Amazon Managed Service for Prometheus 수집기를 사용하려면 Amazon EKS 클러스터에서 지표를 검색하고 가져오는 스크레이퍼를 생성해야 합니다.
-
Amazon EKS 클러스터 생성의 일부로 스크레이퍼를 생성할 수 있습니다. 스크레이퍼 생성을 포함한 Amazon EKS 클러스터를 생성하는 방법에 대한 자세한 내용은 Amazon EKS 사용 설명서의 Amazon EKS 클러스터 생성을 참조하세요.
-
AWS API를 사용하거나 를 사용하여 프로그래밍 방식으로 자체 스크레이퍼를 만들 수 있습니다. AWS CLI
참고
고객 관리 키로 생성한 Amazon Managed Service for Prometheus 작업 영역은 수집에 관리형 컬렉터를 사용할 수 없습니다. AWS
Amazon Managed Service for Prometheus 수집기는 Prometheus 호환 지표를 스크래핑합니다. Prometheus 호환 지표에 대한 자세한 내용은 Prometheus 호환 지표란 무엇입니까? 섹션을 참조하세요.
다음 주제에서는 스크레이퍼를 생성, 관리 및 구성하는 방법을 설명합니다.
스크레이퍼 생성
Amazon Managed Service for Prometheus 수집기는 Amazon EKS 클러스터에서 지표를 검색하고 수집하는 스크레이퍼로 구성됩니다. Amazon Managed Service for Prometheus가 스크레이퍼를 관리하므로 인스턴스, 에이전트 또는 스크레이퍼를 직접 관리할 필요 없이 필요한 확장성, 보안 및 신뢰성을 제공합니다.
Amazon EKS 콘솔을 통해 Amazon EKS 클러스터를 생성하면 스크레이퍼가 자동으로 생성됩니다. 하지만 경우에 따라 스크레이퍼를 직접 생성하기를 원할 수도 있습니다. 예를 들어 기존 Amazon EKS 클러스터에 AWS 관리형 수집기를 추가하거나 기존 수집기의 구성을 변경하려는 경우가 이에 해당합니다.
AWS API 또는 를 사용하여 스크레이퍼를 생성할 수 있습니다. AWS CLI
나만의 스크레이퍼를 만들기 위한 몇 가지 사전 조건은 다음과 같습니다.
-
Amazon EKS 클러스터가 생성되어 있어야 합니다.
-
Amazon EKS 클러스터에 클러스터 엔드포인트 액세스 제어가 프라이빗 액세스를 포함하도록 설정되어 있어야 합니다. 프라이빗 및 퍼블릭을 포함할 수 있지만 프라이빗은 반드시 포함해야 합니다.
참고
클러스터는 Amazon 리소스 이름 (ARN) 을 통해 스크레이퍼와 연결됩니다. 클러스터를 삭제한 다음 이름이 같은 새 클러스터를 생성하면 ARN이 새 클러스터에 재사용됩니다. 이로 인해 스크레이퍼는 새 클러스터에 대한 메트릭 수집을 시도합니다. 클러스터 삭제와 별도로 스크레이퍼를 삭제합니다.
다음은 AWS API와 함께 사용할 수 있는 스크레이퍼 작업의 전체 목록입니다.
-
CreateScraperAPI 작업을 사용하여 스크레이퍼를 생성합니다.
-
ListScrapersAPI 작업을 사용하여 기존 스크레이퍼를 나열하십시오.
-
DeleteScraperAPI 작업으로 스크레이퍼를 삭제합니다.
-
DescribeScraperAPI 작업을 통해 스크레이퍼에 대한 자세한 내용을 확인하세요.
-
GetDefaultScraperConfigurationAPI 작업을 통해 스크레이퍼의 범용 구성을 확보하십시오.
참고
스크래핑하려는 Amazon EKS 클러스터는 Amazon Managed Service for Prometheus가 지표에 액세스하는 것을 허용하도록 구성해야 합니다. 다음 주제에서는 클러스터를 구성하는 방법을 설명합니다.
스크레이퍼를 만들 때 발생하는 일반적인 오류
다음은 새 스크레이퍼를 만들려고 할 때 가장 흔히 발생하는 문제입니다.
-
필수 AWS 리소스가 존재하지 않습니다. 지정된 보안 그룹, 서브넷 및 Amazon EKS 클러스터가 존재해야 합니다.
-
IP 주소 공간이 부족합니다.
CreateScraperAPI로 전달하는 각 서브넷에 사용 가능한 IP 주소가 하나 이상 있어야 합니다.
Amazon EKS 클러스터 구성
Amazon EKS 클러스터는 스크레이퍼가 지표에 액세스하는 것을 허용하도록 구성해야 합니다. 이 구성에는 두 가지 옵션이 있습니다.
-
Amazon EKS 액세스 항목을 사용하면 Amazon 관리 서비스에 Prometheus 수집가가 클러스터에 액세스할 수 있도록 자동으로 제공할 수 있습니다.
-
관리형 지표 스크래핑을 위해 Amazon EKS 클러스터를 수동으로 구성합니다.
다음 주제에서는 이들 각각에 대해 더 자세히 설명합니다.
액세스 항목을 통한 스크레이퍼 액세스를 위해 Amazon EKS를 구성합니다.
Amazon EKS의 액세스 항목을 사용하는 것은 Prometheus용 Amazon Managed Service에서 클러스터의 스크랩 지표에 대한 액세스 권한을 부여하는 가장 쉬운 방법입니다.
스크래핑하려는 Amazon EKS 클러스터는 API 인증을 허용하도록 구성되어야 합니다. 클러스터 인증 모드는 또는 중 하나로 API 설정해야 합니다. API_AND_CONFIG_MAP Amazon EKS 콘솔의 클러스터 세부 정보의 액세스 구성 탭에서 이를 확인할 수 있습니다. 자세한 내용은 Amazon EKS 사용 설명서의 Amazon EKS 클러스터의 Kubernetes 객체에 대한 IAM 역할 또는 사용자 액세스 허용을 참조하십시오.
클러스터를 생성할 때 또는 클러스터를 생성한 후에 스크레이퍼를 생성할 수 있습니다.
-
클러스터 생성 시 — Amazon EKS 콘솔을 통해 Amazon EKS 클러스터를 생성할 때 이 액세스를 구성할 수 있으며 (지침에 따라 클러스터의 일부로 스크레이퍼를 생성) 액세스 입력 정책이 자동으로 생성되어 Amazon Managed Service for Prometheus에 클러스터 지표에 대한 액세스 권한을 부여합니다.
-
클러스터 생성 후 추가 — Amazon EKS 클러스터가 이미 있는 경우 인증 모드를
API또는API_AND_CONFIG_MAP로 설정하면 Amazon Managed Service for Prometheus API 또는 CLI를 통해 생성한 모든 스크레이퍼에 올바른 액세스 입력 정책이 자동으로 생성되며 스크레이퍼는 클러스터에 액세스할 수 있게 됩니다.
액세스 입력 정책이 생성되었습니다.
스크레이퍼를 생성하고 Amazon Managed Service for Prometheus에서 자동으로 액세스 입력 정책을 생성하도록 하면 다음과 같은 정책이 생성됩니다. 액세스 항목에 대한 자세한 내용은 Amazon EKS 사용 설명서의 Kubernetes에 대한 IAM 역할 또는 사용자 액세스 허용을 참조하십시오.
{ "rules": [ { "effect": "allow", "apiGroups": [ "" ], "resources": [ "nodes", "nodes/proxy", "nodes/metrics", "services", "endpoints", "pods", "ingresses", "configmaps" ], "verbs": [ "get", "list", "watch" ] }, { "effect": "allow", "apiGroups": [ "extensions", "networking.k8s.io" ], "resources": [ "ingresses/status", "ingresses" ], "verbs": [ "get", "list", "watch" ] }, { "effect": "allow", "nonResourceURLs": [ "/metrics" ], "verbs": [ "get" ] } ] }
스크레이퍼 액세스를 위한 Amazon EKS 수동 구성
를 사용하여 kubernetes 클러스터에 대한 액세스를 aws-auth ConfigMap 제어하려는 경우에도 Amazon Managed Service for Prometheus 스크레이퍼에게 메트릭에 대한 액세스 권한을 부여할 수 있습니다. 다음 단계를 수행하면 Prometheus용 Amazon 관리 서비스에서 Amazon EKS 클러스터의 스크랩 지표에 액세스할 수 있습니다.
참고
항목에 대한 자세한 내용 ConfigMap 및 액세스 항목은 Amazon EKS 사용 설명서의 IAM 역할 또는 사용자의 Kubernetes 액세스 허용을 참조하십시오.
이 절차에서는 kubectl 및 AWS CLI를 사용합니다. kubectl 설치에 대한 자세한 내용은 Amazon EKS 사용 설명서의 kubectl 설치를 참조하세요.
관리형 지표 스크래핑을 위해 Amazon EKS 클러스터를 수동으로 구성하려면
-
다음 텍스트를 사용하여
clusterrole-binding.yml이라는 파일을 생성합니다.apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRole metadata: name: aps-collector-role rules: - apiGroups: [""] resources: ["nodes", "nodes/proxy", "nodes/metrics", "services", "endpoints", "pods", "ingresses", "configmaps"] verbs: ["describe", "get", "list", "watch"] - apiGroups: ["extensions", "networking.k8s.io"] resources: ["ingresses/status", "ingresses"] verbs: ["describe", "get", "list", "watch"] - nonResourceURLs: ["/metrics"] verbs: ["get"] --- apiVersion: rbac.authorization.k8s.io/v1 kind: ClusterRoleBinding metadata: name: aps-collector-user-role-binding subjects: - kind: User name: aps-collector-user apiGroup: rbac.authorization.k8s.io roleRef: kind: ClusterRole name: aps-collector-role apiGroup: rbac.authorization.k8s.io -
클러스터에서 다음 명령을 실행합니다.
kubectl apply -f clusterrole-binding.yml그러면 클러스터 역할 바인딩 및 규칙이 생성됩니다. 이 예제는 역할 이름으로
aps-collector-role을 사용하고, 사용자 이름으로aps-collector-user를 사용합니다. -
다음 명령은 ID가
scraper-id인 스크레이퍼에 대한 정보를 제공합니다. 이 스크레이퍼는 이전 섹션의 명령을 사용하여 생성한 스크레이퍼입니다.aws amp describe-scraper --scraper-idscraper-id -
describe-scraper의 결과에서 다음과 같은 형식의roleArn을 찾습니다.arn:aws:iam::account-id:role/aws-service-role/scraper.aps.amazonaws.com/AWSServiceRoleForAmazonPrometheusScraper_unique-idAmazon EKS에서는 이 ARN에 대해 다른 형식이 필요합니다. 다음 단계에서 사용할 반환된 ARN의 형식을 조정해야 합니다. 다음 형식에 맞게 편집합니다.
arn:aws:iam::account-id:role/AWSServiceRoleForAmazonPrometheusScraper_unique-id예를 들어 이 ARN은
arn:aws:iam::111122223333:role/aws-service-role/scraper.aps.amazonaws.com/AWSServiceRoleForAmazonPrometheusScraper_1234abcd-56ef-7다음과 같이 작성해야 합니다.
arn:aws:iam::111122223333:role/AWSServiceRoleForAmazonPrometheusScraper_1234abcd-56ef-7 -
이전 단계에서 수정한
roleArn과 클러스터 이름 및 리전을 사용하여 클러스터에서 다음 명령을 실행합니다.eksctl create iamidentitymapping --clustercluster-name--regionregion-id--arnroleArn--username aps-collector-user이렇게 하면 스크레이퍼가
clusterrole-binding.yml파일에서 생성한 역할과 사용자를 사용하여 클러스터에 액세스할 수 있습니다.
스크레이퍼 찾기 및 삭제
AWS API 또는 를 사용하여 계정의 스크래퍼를 나열하거나 삭제할 수 있습니다. AWS CLI
참고
최신 버전의 AWS CLI 또는 SDK를 사용하고 있는지 확인하세요. 최신 버전은 보안 업데이트뿐 아니라 최신 특징과 기능을 제공합니다. 또는 항상 up-to-date 명령줄 환경을 자동으로 제공하는 AWS Cloudshell을 사용할 수도 있습니다.
계정의 모든 스크레이퍼를 나열하려면 API 작업을 사용하세요. ListScrapers
또는 를 사용하여 다음과 같이 호출할 AWS CLI수 있습니다.
aws amp list-scrapers
ListScrapers가 계정의 모든 스크레이퍼를 반환합니다. 예를 들면 다음과 같습니다.
{ "scrapers": [ { "scraperId": "s-1234abcd-56ef-7890-abcd-1234ef567890", "arn": "arn:aws:aps:us-west-2:123456789012:scraper/s-1234abcd-56ef-7890-abcd-1234ef567890", "roleArn": "arn:aws:iam::123456789012:role/aws-service-role/AWSServiceRoleForAmazonPrometheusScraper_1234abcd-2931", "status": { "statusCode": "DELETING" }, "createdAt": "2023-10-12T15:22:19.014000-07:00", "lastModifiedAt": "2023-10-12T15:55:43.487000-07:00", "tags": {}, "source": { "eksConfiguration": { "clusterArn": "arn:aws:eks:us-west-2:123456789012:cluster/my-cluster", "securityGroupIds": [ "sg-1234abcd5678ef90" ], "subnetIds": [ "subnet-abcd1234ef567890", "subnet-1234abcd5678ab90" ] } }, "destination": { "ampConfiguration": { "workspaceArn": "arn:aws:aps:us-west-2:123456789012:workspace/ws-1234abcd-5678-ef90-ab12-cdef3456a78" } } } ] }
스크레이퍼를 삭제하려면 작업을 사용하여 삭제하려는 스크레이퍼를 찾은 다음 ListScrapers 작업을 사용하여 삭제하십시오. scraperId DeleteScraper
또는 를 사용하여 다음과 AWS CLI같이 호출하십시오.
aws amp delete-scraper --scraper-idscraperId
스크레이퍼 구성
Prometheus 호환 스크레이퍼 구성을 사용하여 스크레이퍼가 지표를 검색하고 수집하는 방법을 제어할 수 있습니다. 예를 들어 지표가 WorkSpace로 전송되는 간격을 변경할 수 있습니다. 레이블 재지정을 사용하여 지표의 레이블을 동적으로 다시 작성할 수도 있습니다. 스크레이퍼 구성은 스크레이퍼 정의의 일부인 YAML 파일입니다.
새 스크레이퍼가 생성되면 API 호출에서 base64로 인코딩된 YAML 파일을 제공하여 구성을 지정합니다. Amazon Managed Service for Prometheus API에서 GetDefaultScraperConfiguration 작업이 포함된 범용 구성 파일을 다운로드할 수 있습니다.
스크레이퍼의 구성을 수정하려면 스크레이퍼를 삭제하고 새 구성으로 다시 생성합니다.
지원되는 구성
가능한 값에 대한 자세한 분석을 포함하여 스크레이퍼 구성 형식에 대한 자세한 내용은 Prometheus 설명서의 구성을<scrape_config> 옵션은 가장 일반적으로 필요한 옵션을 설명합니다.
지원되는 서비스는 Amazon EKS뿐이므로 지원되는 유일한 서비스 검색 구성 (<*_sd_config>) 은 입니다. <kubernetes_sd_config>
허용되는 구성 섹션의 전체 목록은 다음과 같습니다.
-
<global> -
<scrape_config> -
<static_config> -
<relabel_config> -
<metric_relabel_configs> -
<kubernetes_sd_config>
이 섹션의 제한 사항은 샘플 구성 파일 뒤에 나열되어 있습니다.
샘플 구성 파일
다음은 스크래핑 간격이 30초인 샘플 YAML 구성 파일입니다.
global: scrape_interval: 30s external_labels: clusterArn: apiserver-test-2 scrape_configs: - job_name: pod_exporter kubernetes_sd_configs: - role: pod - job_name: cadvisor scheme: https authorization: type: Bearer credentials_file: /var/run/secrets/kubernetes.io/serviceaccount/token kubernetes_sd_configs: - role: node relabel_configs: - action: labelmap regex: __meta_kubernetes_node_label_(.+) - replacement: kubernetes.default.svc:443 target_label: __address__ - source_labels: [__meta_kubernetes_node_name] regex: (.+) target_label: __metrics_path__ replacement: /api/v1/nodes/$1/proxy/metrics/cadvisor # apiserver metrics - scheme: https authorization: type: Bearer credentials_file: /var/run/secrets/kubernetes.io/serviceaccount/token job_name: kubernetes-apiservers kubernetes_sd_configs: - role: endpoints relabel_configs: - action: keep regex: default;kubernetes;https source_labels: - __meta_kubernetes_namespace - __meta_kubernetes_service_name - __meta_kubernetes_endpoint_port_name # kube proxy metrics - job_name: kube-proxy honor_labels: true kubernetes_sd_configs: - role: pod relabel_configs: - action: keep source_labels: - __meta_kubernetes_namespace - __meta_kubernetes_pod_name separator: '/' regex: 'kube-system/kube-proxy.+' - source_labels: - __address__ action: replace target_label: __address__ regex: (.+?)(\\:\\d+)? replacement: $1:10249
AWS 관리 컬렉터에만 적용되는 제한은 다음과 같습니다.
-
스크래핑 간격 - 스크레이퍼 구성에서는 스크래핑 간격을 30초 미만으로 지정할 수 없습니다.
-
대상 -
static_config의 대상을 IP 주소로 지정해야 합니다. -
권한 부여 — 승인이 필요하지 않은 경우 생략합니다. 필요한 경우 승인은 반드시 파일을 가리켜야
Bearer하며 파일을/var/run/secrets/kubernetes.io/serviceaccount/token가리켜야 합니다. 즉, 권한 부여 섹션을 사용하는 경우 권한 부여 섹션은 다음과 같아야 합니다.authorization: type: Bearer credentials_file: /var/run/secrets/kubernetes.io/serviceaccount/token참고
type: Bearer가 기본값이므로 생략할 수 있습니다.
스크레이퍼 구성 문제 해결
Amazon Managed Service for Prometheus 수집기는 자동으로 지표를 검색하고 스크래핑합니다. 하지만 Amazon Managed Service for Prometheus WorkSpace에 표시될 것으로 예상되는 지표가 표시되지 않는 경우 어떻게 문제를 해결할 수 있습니까?
up 지표는 유용한 도구입니다. Amazon Managed Service for Prometheus 수집기가 발견한 각 엔드포인트에 대해 이 지표를 자동으로 제공합니다. 이 지표에는 수집기 내에서 발생하는 문제를 해결하는 데 도움이 되는 세 가지 상태가 있습니다.
-
up이 존재하지 않음 - 엔드포인트에 대한up지표가 없는 경우 수집기가 엔드포인트를 찾을 수 없었음을 의미합니다.엔드포인트가 존재한다고 확신하는 경우 스크래핑 구성을 조정해야 할 수 있습니다. 검색
relabel_config를 조정해야 할 수도 있고, 검색에 사용되는role에 문제가 있을 수도 있습니다. -
up이 존재하지만 항상 0임 -up이 존재하지만 0인 경우 수집기는 엔드포인트를 검색할 수 있지만 Prometheus 호환 지표를 찾을 수 없습니다.이 경우 엔드포인트에 대한
curl명령을 직접 사용해 볼 수 있습니다. 사용 중인 프로토콜 (http또는https), 엔드포인트 또는 포트와 같은 세부 정보가 정확한지 확인할 수 있습니다. 또한 엔드포인트가 유효한200응답으로 응답하고 있으며 Prometheus 형식을 따르고 있는지 확인할 수 있습니다. 마지막으로, 응답 본문은 최대 허용 크기보다 클 수 없습니다. ( AWS 관리형 컬렉터에 대한 제한은 다음 섹션을 참조하십시오.) -
up이 존재하고 0보다 큰 경우 -up이 존재하고 0보다 크면 지표가 Amazon Managed Service for Prometheus로 전송됩니다.Amazon Managed Service for Prometheus(또는 Amazon Managed Grafana와 같은 대체 대시보드)에서 올바른 지표를 찾고 있는지 확인합니다. curl을 다시 사용하여
/metrics엔드포인트에서 예상 데이터를 확인할 수 있습니다. 또한 스크레이퍼당 엔드포인트 수와 같은 다른 한도를 초과하지 않았는지도 확인합니다. 를 사용하여 지표 수를 확인하여 스크랩되는 지표 엔드포인트 수를up확인할 수 있습니다.count(up)
스크레이퍼 제한 사항
Amazon Managed Service for Prometheus에서 제공하는 완전 관리형 스크레이퍼에는 몇 가지 제한이 있습니다.
-
리전 - EKS 클러스터, 관리형 스크레이퍼 및 Amazon Managed Service for Prometheus WorkSpace가 모두 동일한 AWS 리전에 있어야 합니다.
-
계정 - EKS 클러스터, 관리형 스크레이퍼 및 Amazon Managed Service for Prometheus WorkSpace가 모두 동일한 AWS 계정에 있어야 합니다.
-
수집기 - 계정별로 리전당 최대 10개의 Amazon Managed Service for Prometheus 스크레이퍼를 보유할 수 있습니다.
참고
할당량 증가를 요청
하여 이 한도에 대한 증가를 요청할 수 있습니다. -
지표 응답 - 한
/metrics엔드포인트 요청의 응답 본문은 50메가바이트(MB)를 초과할 수 없습니다. -
스크레이퍼당 엔드포인트 - 스크레이퍼는 최대 30,000개의 엔드포인트를 스크래핑할 수 있습니다.
-
스크래핑 간격 - 스크레이퍼 구성에서는 스크래핑 간격을 30초 미만으로 지정할 수 없습니다.
