기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon CloudWatch 데이터 소스에 연결 Amazon Managed Grafana를 사용하면 Grafana 워크스페이스 콘솔의 데이터 소스 구성 옵션을 사용하여 Amazon CloudWatch를 AWS 데이터 소스로 추가할 수 있습니다. 이 기능은 기존 CloudWatch 계정을 검색하여 CloudWatch를 데이터 소스로 추가하는 작업을 간소화하고 CloudWatch에 액세스하는 데 필요한 인증 자격 증명의 구성을 관리합니다. 이 방법을 사용하여 인증을 설정하고 CloudWatch를 데이터 소스로 추가할 수 있습니다. 또는 자체 관리형 Grafana 서버에서와 동일한 방법을 사용하여 데이터 소스와 필요한 인증 자격 증명을 수동으로 설정할 수 있습니다. **Topics** + [AWS 데이터 소스 구성을 사용하여 CloudWatch를 데이터 소스로 추가](adding-CloudWatch-AWS-config.md) + [수동으로 CloudWatch를 데이터 소스로 추가](adding--CloudWatch-manual.md) + [쿼리 편집기 사용하기](CloudWatch-using-the-query-editor.md) + [큐레이션된 대시보드](CloudWatch-curated-dashboards.md) + [템플릿 기반 쿼리](cloudwatch-templated-queries.md) + [ec2\$1instance\$1attribute 예제 사용](cloudwatch-ec2-instance-attribute-examples.md) + [JSON 형식 템플릿 변수 사용](cloudwatch-using-json-format-template-variables.md) + [가격 책정](cloudwatch-pricing.md) + [Service Quotas](cloudwatch-service-quotas.md) + [교차 계정 관찰성](cloudwatch-cross-account.md) # AWS 데이터 소스 구성을 사용하여 CloudWatch를 데이터 소스로 추가 AWS 데이터 소스 구성을 사용하려면 먼저 Amazon Managed Grafana 콘솔을 사용하여 계정 또는 전체 조직 단위에서 CloudWatch 리소스를 읽는 데 필요한 IAM 정책을 워크스페이스에 부여하는 서비스 관리형 IAM 역할을 활성화합니다. 그런 다음, Amazon Managed Grafana 워크스페이스 콘솔을 사용하여 CloudWatch를 데이터 소스로 추가합니다. **AWS 데이터 소스 구성을 사용하여 CloudWatch를 데이터 소스로 추가하려면** 1. [https://console.aws.amazon.com/grafana/](https://console.aws.amazon.com/grafana/home/)에서 Amazon Managed Grafana 콘솔을 엽니다. 1. 탐색 창에서 메뉴 아이콘을 선택하고 **모든 워크스페이스**를 선택하세요. 1. 워크스페이스 이름을 선택하세요. 1. 이 워크스페이스를 생성할 때이 워크스페이스에 서비스 관리형 권한을 사용하도록 선택하지 않은 경우 Grafana 워크스페이스 콘솔에서 AWS 데이터 소스 구성 옵션을 사용할 수 있도록 적절한 IAM 역할 및 정책이 활성화되도록 고객 관리형 권한을 사용하여 서비스 관리형 권한을 사용하는 것으로 변경합니다. 이를 수행하려면 **IAM 역할** 옆의 편집 아이콘을 선택하고 **서비스 관리형**, **변경 사항 저장**을 선택하세요. 자세한 내용은 [AWS 데이터 소스에 대한 Amazon Managed Grafana 권한 및 정책](AMG-manage-permissions.md) 단원을 참조하십시오. 1. **데이터 소스** 탭을 선택하세요. 1. **Amazon CloudWatch** 확인란을 선택하고 **작업**, **서비스 관리형 정책 활성화**를 선택하세요. 1. **데이터 소스** 탭을 다시 선택하세요. 1. **Amazon CloudWatch** 행에서 **Grafana에서 구성**을 선택하세요. 1. 필요한 경우 IAM Identity Center를 사용하여 Grafana 워크스페이스 콘솔에 로그인합니다. 1. Grafana 워크스페이스 콘솔의 탐색 표시줄에서 AWS 아이콘을 선택한 다음, **AWS 서비스**, **CloudWatch**를 선택하세요. 1. CloudWatch 데이터 소스에서 쿼리할 기본 리전을 선택하세요. 1. 원하는 계정을 선택한 다음, **데이터 소스 추가**를 선택하세요. # 수동으로 CloudWatch를 데이터 소스로 추가 **수동으로 CloudWatch 데이터 소스를 추가하는 방법** 1. Grafana 콘솔 사이드 메뉴에서 **구성**(톱니) 아이콘 위에 마우스를 올려 놓고 **데이터 소스**를 선택하세요. 1. **데이터 소스 추가**를 선택합니다. 1. **CloudWatch** 데이터 소스를 선택하세요. 필요한 경우 검색 상자에서 **CloudWatch**를 입력하기 시작하면 해당 항목을 찾는 데 도움이 됩니다. ## CloudWatch 설정 다음 CloudWatch 설정이 적용됩니다. | 이름 | 설명 | | --- | --- | | `Name` | 데이터 소스 이름. 패널 및 쿼리에서 데이터 소스를 보는 방법입니다. | | `Default` | 새 패널에 대해 사전에 선택할 데이터 소스를 지정합니다. | | `Default Region` | 쿼리 편집기에서 리전을 설정합니다. 쿼리별 기준으로 변경할 수 있습니다. | | `Namespaces of Custom Metrics` | 사용자 지정 지표의 CloudWatch 네임스페이스를 지정합니다. 쉼표로 구분된 여러 네임스페이스를 포함할 수 있습니다. | | `Auth Provider` | 자격 증명을 가져올 제공업체를 지정합니다. | | `Assume Role Arn` | 수임할 역할의 Amazon 리소스 이름(ARN)을 지정합니다. | | `External ID` | (선택 사항) 외부 ID를 지정합니다. 외부 ID로 생성된 다른에서 역할을 수임 AWS 계정 하는 경우를 사용합니다. | | `Timeout` | 특별히 CloudWatch Logs 쿼리에 대한 제한 시간을 구성합니다. | | `X-Ray trace links` | 로그에 `@xrayTraceId` 필드가 포함된 경우 로그에서 링크를 자동으로 추가하려면 데이터 소스 구성의 **X-Ray 추적 링크** 섹션에서 X-Ray 데이터 소스를 연결합니다. [X-Ray 데이터 소스](x-ray-data-source.md)가 이미 구성되어 있어야 합니다. | ### Authentication Amazon Managed Grafana 및 CloudWatch 간 인증을 활성화하려면 Amazon Managed Grafana 콘솔을 사용하여 필요한 정책 및 권한을 빠르게 생성할 수 있습니다. 또는 자체 관리형 Grafana 서버에서와 동일한 몇 가지 방법을 사용하여 인증을 수동으로 설정할 수 있습니다. Amazon Managed Grafana 데이터 소스 구성을 사용하여 정책을 빠르게 설정하려면 [AWS 데이터 소스 구성을 사용하여 CloudWatch를 데이터 소스로 추가](adding-CloudWatch-AWS-config.md)의 단계를 수행합니다. 권한을 수동으로 설정하려면 다음 섹션의 방법 중 하나를 사용합니다. #### AWS 자격 증명 세 가지 인증 방법을 사용할 수 있습니다. + **AWS SDK 기본값** - 워크스페이스에 연결된 역할에 정의된 권한을 사용합니다. 자세한 내용은 [고객 관리형 권한](AMG-manage-permissions.md#AMG-customer-managed) 단원을 참조하십시오. + **액세스 및 보안 키** - AWS SDK for Go `StaticProvider`에 해당합니다. 주어진 액세스 키 ID 및 보안 암호 키를 사용하여 인증합니다. 이 방법에는 폴백이 없으며 제공된 키 페어가 작동하지 않으면 실패합니다. #### IAM 역할 현재 CloudWatch에 대한 모든 액세스는 공식 AWS SDK를 사용하여 Grafana 백엔드에서 서버 측에서 수행됩니다. *AWS SDK 기본* 인증 방법을 선택하고 Grafana 서버가 실행 중인 경우 IAM 역할을 사용하여 인증을 자동으로 처리할 AWS수 있습니다. 자세한 내용은 [IAM 역할](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)을 참조하세요. #### IAM 정책 Grafana는 CloudWatch 지표와 EC2 태그, 인스턴스, 리전을 읽을 수 있도록 IAM을 통해 부여된 권한이 필요합니다. 이러한 권한을 IAM 역할에 연결하고 역할 수임을 위해 기본 제공 Grafana 지원을 사용할 수 있습니다. 다음 코드 예제에서는 최소 정책을 보여줍니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "AllowReadingMetricsFromCloudWatch", "Effect": "Allow", "Action": [ "cloudwatch:DescribeAlarmsForMetric", "cloudwatch:DescribeAlarmHistory", "cloudwatch:DescribeAlarms", "cloudwatch:ListMetrics", "cloudwatch:GetMetricStatistics", "cloudwatch:GetMetricData", "cloudwatch:GetInsightRuleReport" ], "Resource": "*" }, { "Sid": "AllowReadingLogsFromCloudWatch", "Effect": "Allow", "Action": [ "logs:DescribeLogGroups", "logs:GetLogGroupFields", "logs:StartQuery", "logs:StopQuery", "logs:GetQueryResults", "logs:GetLogEvents" ], "Resource": "*" }, { "Sid": "AllowReadingTagsInstancesRegionsFromEC2", "Effect": "Allow", "Action": [ "ec2:DescribeTags", "ec2:DescribeInstances", "ec2:DescribeRegions" ], "Resource": "*" }, { "Sid": "AllowReadingResourcesForTags", "Effect": "Allow", "Action": "tag:GetResources", "Resource": "*" }, { "Sid": "AllowReadingAcrossAccounts", "Effect": "Allow", "Action": [ "oam:ListSinks", "oam:ListAttachedLinks" ], "Resource": "*" } ] } ``` ------ #### 역할 수임 `Assume Role ARN` 필드를 사용하면 해당되는 경우 수임할 IAM 역할을 지정할 수 있습니다. 이 정보를 비워 두면 제공된 자격 증명을 직접 사용하며, 연결된 역할 또는 사용자에게 필요한 권한이 있어야 합니다. 이 필드가 비어 있지 않으면 제공된 자격 증명이 `sts:AssumeRole` 직접 호출을 수행하는 데 사용됩니다. # 쿼리 편집기 사용하기 Amazon Managed Grafana의 CloudWatch 데이터 소스는 CloudWatch로 데이터를 전송하는 다양한 AWS 서비스에서 지표와 로그를 검색하고 분석할 수 있는 강력한 쿼리 편집기를 제공합니다. 쿼리 편집기에서는 지표 검색 및 CloudWatch Logs라는 두 가지 고유한 쿼리 모드를 지원합니다. 지표에 대한 쿼리 편집기 모드에서는 CloudWatch API를 사용하여 CloudWatch에 업로드된 지표를 찾습니다. 로그에 대한 모드에서는 CloudWatch Logs API를 사용하여 로그 레코드를 찾습니다. 각 모드에는 고유한 특수 쿼리 편집기가 있습니다. 편집기 상단의 쿼리 모드 스위치를 사용하여 쿼리할 API를 선택하세요. **Topics** + [지표 쿼리 편집기 사용](CloudWatch-using-the-metric-query-editor.md) + [Amazon CloudWatch Logs 쿼리 편집기 사용](CloudWatch-using-the-logs-query-editor.md) # 지표 쿼리 편집기 사용 지표 쿼리 편집기를 사용하면 **지표 검색** 및 **지표 쿼리**와 같은 두 가지 유형의 쿼리를 빌드할 수 있습니다. **지표 쿼리** 옵션은 CloudWatch Metrics Insights를 사용하여 데이터를 쿼리합니다. ## 공통 쿼리 편집기 필드 **지표 검색** 및 **지표 쿼리** 모드 모두에 공통된 세 가지 필드가 있습니다. **공통 필드** **Id** `GetMetricData` API를 사용하려면 모든 쿼리에 고유한 ID가 있어야 합니다. 이 필드를 사용하여 원하는 ID를 지정합니다. ID는 숫자, 문자, 밑줄을 포함할 수 있으며, 소문자로 시작해야 합니다. ID를 지정하지 않은 경우 Amazon Managed Grafana는 `query[refId of the current query row]` 패턴을 사용하여 ID를 생성합니다. 예를 들어 `queryA`는 패널 편집기의 첫 번째 쿼리 행을 나타냅니다. **Period** 기간은 특정 Amazon CloudWatch 통계와 연관된 시간의 길이입니다. 기간은 초 단위로 정의됩니다. 유효한 값으로, 1, 5, 10, 30 또는 60의 배수가 포함됩니다. 기간 필드를 비워 두거나 `auto`로 설정하면 시간 범위 및 CloudWatch 보존 정책에 따라 자동으로 계산됩니다. 사용하는 수식은 `time range in seconds / 2000`입니다. 이에 따라 보존을 기반으로 기간을 제거한 후 미리 정의된 기간 배열 [60, 300, 900, 3600, 21600, 86400]에서 다음으로 높은 값으로 이동합니다. Amazon Managed Grafana에서 사용 중인 기간을 확인하려면 쿼리 편집기에서 **쿼리 미리 보기 표시**를 선택하세요. **Alias** 다음 별칭 패턴이 적용됩니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/grafana/latest/userguide/CloudWatch-using-the-metric-query-editor.html) # 지표 검색 옵션 사용 **지표 검색**에서 유효한 쿼리를 생성하려면 네임스페이스, 지표 이름 및 하나 이상의 통계를 지정해야 합니다. **정확히 일치**가 켜져 있는 경우 쿼리하려는 지표의 모든 차원도 지정해야 합니다. 지표 스키마는 정확히 일치해야 합니다. 자세한 내용은 [CloudWatch 검색 표현식 구문](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/search-expression-syntax.html)을 참조하세요. **정확히 일치**가 꺼진 경우 필터링하려는 차원 수를 지정할 수 있습니다. 필터 기준과 일치하는 최대 100개의 지표가 반환됩니다. ## 차원 와일드카드 문자를 사용한 동적 쿼리 하나 이상의 차원 값에 별표(`*`) 와일드카드 문자를 사용하여 동적 지표 목록을 모니터링할 수 있습니다. 이를 통해 EC2 인스턴스 또는 컨테이너와 같은 AWS 리소스에 대한 지표를 모니터링할 수 있습니다. 예를 들어 새로운 인스턴스가 오토 스케일링 이벤트의 일환으로 생성되면 새로운 인스턴스 ID를 추적하지 않아도 그래프에 자동으로 표시됩니다. 이 기능은 현재 최대 100개의 지표 검색으로 제한됩니다. **쿼리 미리 보기 표시**를 선택하여 와일드카드 문자를 지원하도록 자동으로 빌드된 검색 표현식을 볼 수 있습니다. 기본적으로 검색 표현식은 쿼리된 지표가 정의된 차원 이름과 정확히 일치해야 하는 방식으로 정의됩니다. 즉, 이 예제에서는 정확히 하나의 `InstanceId` 차원을 포함하는 지표만 반환됩니다. 다른 차원이 정의된 지표를 포함하려면 **정확히 일치**를 끄면 됩니다. 또한 **정확히 일치**를 끄면 와일드카드 문자를 사용하지 않더라도 검색 표현식이 생성됩니다. Grafana는 최소한 네임스페이스, 지표 이름 및 정의된 모든 차원과 일치하는 지표를 검색합니다. ## 다중 값 템플릿 변수 다중 값 템플릿 변수를 기반으로 차원 값을 정의할 때 검색 표현식을 사용하여 일치하는 지표를 쿼리합니다. 이렇게 하면 하나의 쿼리에서 여러 템플릿 변수를 사용할 수 있습니다. 또한 **정확히 일치** 옵션이 꺼진 쿼리에서 템플릿 변수를 사용할 수 있습니다. 검색 표현식은 현재 1,024자로 제한되므로 값 목록이 긴 경우 쿼리가 실패할 수 있습니다. 특정 차원 이름에 대한 값이 있는 모든 지표를 쿼리하려면 `All` 옵션 대신 별표(`*`) 와일드카드 문자를 사용하는 것이 좋습니다. 다중 값 템플릿 변수의 사용은 차원 값에 대해서만 지원됩니다. `Region`, `Namespace` 또는 `Metric Name`에 다중 값 템플릿 변수를 사용하는 것은 지원되지 않습니다. ## 지표 수학 표현식 수학 함수를 사용해 CloudWatch 지표 위에서 연산을 수행하여 새 시계열 지표를 생성할 수 있습니다. 산술 연산자, 단항 뺄셈 및 기타 함수가 지원되며 CloudWatch 지표에 적용할 수 있습니다. 지표 수학에 대한 자세한 설명은 [지표 수학 사용](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-metric-math.html)을 참조하세요. 예를 들어 지표에 산술 연산을 적용하려면 원시 지표에 ID(고유 문자열)를 지정합니다. 그런 다음, 이 ID를 사용하고 새 지표의 `Expression` 필드에 산술 연산을 적용할 수 있습니다. `Expression` 필드를 사용하여 `queryA * 2`와 같은 다른 쿼리를 참조하는 경우 해당 쿼리를 기반으로 알림 규칙을 생성할 수 없습니다. ## Period ‘기간’은 특정 Amazon CloudWatch 통계와 연관된 시간의 길이입니다. 기간은 초 단위로 정의됩니다. 유효한 값으로, 1, 5, 10, 30 또는 60의 배수가 포함됩니다. 기간 필드를 비워 두거나 **자동**으로 설정하면 시간 범위에 따라 자동으로 계산됩니다. 사용된 공식은 `time range in seconds / 2000`이며, 이후 미리 정의된 기간 `[60, 300, 900, 3600, 21600, 86400]`의 배열에서 다음으로 높은 값으로 이동합니다. Amazon Managed Grafana에서 사용 중인 기간을 확인하려면 쿼리 편집기에서 **쿼리 미리 보기 표시**를 선택하세요. ## Grafana 패널에서 CloudWatch 콘솔로 딥링크 연결 패널에서 시계열을 선택하면 **CloudWatch 콘솔에서 보기** 링크가 있는 컨텍스트 메뉴가 표시됩니다. 이 링크를 선택하면 CloudWatch 콘솔로 이동하는 새 탭이 열리고 해당 쿼리에 대한 모든 지표가 표시됩니다. 현재 CloudWatch 콘솔에 로그인하지 않은 경우 링크를 누르면 로그인 페이지로 이동합니다. 제공된 링크는 모든에 유효하지 AWS 계정 만 Grafana에서 선택한 데이터 소스에 해당하는에 로그인 AWS 계정 한 경우에만 올바른 지표를 표시합니다. 이 기능은 지표 수학 표현식을 기반으로 하는 지표에서 사용할 수 없습니다. # 지표 쿼리 옵션을 사용하여 CloudWatch Metrics Insights 데이터 쿼리 **참고** Amazon CloudWatch Metrics Insights는 평가판으로 제공됩니다. CloudWatch Metrics Insights 기능은 모든 AWS 계정에서 이용 가능합니다. 기능은 변경될 수 있습니다. **지표 쿼리 편집기**에서 `metric query` 모드를 선택하여 CloudWatch Metrics Insights 데이터를 쿼리할 수 있습니다. CloudWatch Metrics Insights는 대규모 지표를 쿼리하는 데 사용할 수 있는 강력한 고성능 SQL 쿼리 엔진입니다. 빠르고 유연한 SQL 기반 쿼리 엔진으로, 모든 CloudWatch 지표 내 추세와 패턴을 실시간으로 식별하는 데 사용할 수 있습니다. SQL 언어를 사용합니다. Metrics Insights 쿼리 구문에 대한 자세한 내용은 [쿼리 구문 및 키워드](#metrics-insights-syntax-keywords) 섹션을 참조하세요. ## 쿼리 구문 및 키워드 CloudWatch Metrics Insights는 SQL 언어를 사용합니다. 다음 예제에서는 쿼리 구문을 보여줍니다. ``` SELECT FUNCTION(metricName) FROM namespace | [ SCHEMA(namespace[, labelKey [, ...] ]) ] [ WHERE labelKey OPERATOR labelValue [AND|OR|([...])*] [, ...] ] [ GROUP BY labelKey [, ...]] [ ORDER BY FUNCTION() [DESC | ASC] ] [ LIMIT number] ``` 키워드는 대소문자를 구분하지 않지만 식별자는 대소문자를 구분합니다. 식별자에는 지표 이름, 네임스페이스 및 차원이 포함됩니다. 다음 표에서는 가능한 키워드 및 해당 설명을 제공합니다. | 키워드 | 설명 | | --- | --- | | FUNCTION | 필수 사항입니다. 사용할 집계 함수를 지정하고 쿼리할 지표의 이름도 지정합니다. 유효한 값은 AVG, COUNT, MAX, MIN 및 SUM입니다. | | MetricName | 필수 사항입니다. 예를 들어 CPUUtilization입니다. | | FROM | 필수 사항입니다. 지표의 소스를 지정합니다. 쿼리할 지표를 포함하는 지표 네임스페이스 또는 SCHEMA 테이블 함수를 지정할 수 있습니다. 일부 네임스페이스 예제로 AWS/EC2 및 AWS/Lambda가 있습니다. | | SCHEMA | (선택 사항) 쿼리 결과를 필터링하여 정확히 일치하는 지표 또는 일치하지 않는 지표만 표시합니다. | | WHERE | (선택 사항) 결과를 필터링하여 지정된 표현식과 일치하는 지표만 표시합니다. 예를 들어 WHERE InstanceType \$1= 'c3.4xlarge'입니다. | | GROUP BY | (선택 사항) 쿼리 결과를 여러 시계열로 그룹화합니다. 예를 들어 GROUP BY ServiceName입니다. | | ORDER BY | (선택 사항) 반환할 시계열의 순서를 지정합니다. 옵션으로 ASC 및 DESC가 있습니다. | | LIMIT | (선택 사항) 반환할 시계열 수를 제한합니다. | 다음은 몇 가지 예시입니다. + ``` SELECT AVG(CPUUtilization) FROM "AWS/EC2" ``` `AWS/EC2` 네임스페이스의 모든 `CPUUtilization` 지표를 일치시키고(이때 차원 무시) 집계된 단일 시계열을 반환합니다. + ``` SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2") ``` `AWS/EC2` 네임스페이스에서 정의된 차원이 없는 `CPUUtilization` 지표만 일치시킵니다. + ``` SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId) ``` CloudWatch에 보고된 `CPUUtilization` 지표를 일치시킵니다(이때 정확히 하나의 차원 `InstanceId` 포함). + ``` SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone) ``` `AWS/ApplicationELB`에서 CloudWatch에 보고된 `RequestCount` 지표만 일치시킵니다(이때 정확히 두 개의 `LoadBalancer` 및 `AvailabilityZone` 차원 포함). 레이블 값은 작은따옴표로 묶어야 합니다. ### 이스케이프 문자 쿼리에서 레이블 값은 항상 작은따옴표로 묶어야 합니다.   예를 들어 `SELECT MAX(CPUUtilization) FROM "AWS/EC2" WHERE AutoScalingGroupName = 'my-production-fleet'`입니다. 문자, 숫자 및 밑줄(`_`) 이외의 문자가 포함된 지표 네임스페이스, 지표 이름 및 레이블 키는 큰따옴표로 묶어야 합니다. 예를 들어 `SELECT MAX("My.Metric")`입니다. 이 중 하나에 큰따옴표 자체(예: `Bytes"Input"`)가 포함된 경우 `SELECT AVG("Bytes\"Input\"")`에서와 같이 해당 큰따옴표를 백슬래시로 이스케이프 처리해야 합니다. 지표 네임스페이스, 지표 이름 또는 레이블 키에 Metrics Insights의 예약된 키워드 단어가 포함되어 있는 경우 이러한 단어도 큰따옴표로 묶어야 합니다. 예를 들어 `LIMIT`으로 이름 붙인 지표가 있는 경우 `SELECT AVG("LIMIT")`를 사용합니다. 예약어가 포함되어 있지 않더라도 네임스페이스, 지표 이름 또는 레이블을 큰따옴표로 묶는 것도 유효합니다. ## 빌더 모드 및 코드 모드 `Builder` 모드 또는 `Code` 모드에서 쿼리를 생성할 수 있습니다. **`Builder` 모드에서 쿼리를 생성하는 방법** 1. 이전 테이블의 정보를 사용하여 지표 네임스페이스, 지표 이름, 필터, 그룹 및 정렬 옵션을 찾아 선택하세요. 1. 이러한 각 옵션에 대해 가능한 옵션 목록 중에서 선택하세요. **`Code` 모드에서 쿼리를 생성하는 방법** 1. 코드 편집기에 쿼리를 작성하세요. 1. 쿼리를 실행하려면 코드 편집기에서 **쿼리 실행**을 선택하세요. `builder` 모드에서 쿼리를 생성하는 방법 + 위 테이블의 정보를 사용하여 지표 네임스페이스, 지표 이름, 필터, 그룹 및 정렬 옵션을 찾아 선택하세요. + 이러한 각 옵션에 대해 가능한 옵션 목록 중에서 선택하세요. Grafana는 선택 사항에 따라 SQL 쿼리를 자동으로 작성합니다. `code` 모드에서 쿼리를 생성하는 방법 + 코드 편집기에 쿼리를 작성하세요. + 쿼리를 실행하려면 코드 편집기에서 **쿼리 실행**을 선택하세요. 코드 편집기에는 키워드, 집계, 네임스페이스, 지표, 레이블 및 레이블 값에 대한 제안을 제공하는 기본 제공 자동 완성 기능이 있습니다. 제안은 공백, 쉼표 또는 달러 기호를 입력할 때 표시됩니다. `CTRL+Space` 키보드 조합을 사용할 수도 있습니다. 코드 편집기에서 쿼리를 자동으로 완료할 수 있습니다. 그러나 코드 편집기에서 템플릿 변수를 사용하면 자동 완성이 방해를 받을 수 있습니다. ## CloudWatch Metrics Insights 예제 **참고** CloudWatch Metrics Insights는 평가판이 공개되어 있습니다. 미리 보기는 모든 AWS 계정에 열려 있으며 액세스를 요청할 필요가 없습니다. 정식 출시를 발표하기 전에 기능이 추가되거나 변경될 수 있습니다. 이 섹션에는 쿼리 편집기에서 직접 복사 및 사용하거나 복사 및 수정할 수 있는 유용한 CloudWatch Metrics Insights 쿼리의 예제가 포함되어 있습니다. 이러한 예제 중 일부는 콘솔에서 이미 사용할 수 있으며 **지표(Metrics)** 보기의 **쿼리 추가(Add query)**를 선택하여 액세스할 수 있습니다. ### EC2 예제 인스턴스당 CPU 사용률 지표 보기 ``` SELECT AVG(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId ``` 전체 플릿에서 평균 CPU 사용률 보기 ``` SELECT AVG(CPUUtilization) FROM SCHEMA("AWS/EC2", InstanceId) ``` 평균 CPU 사용률이 가장 높은 인스턴스 10개 보기 ``` SELECT MAX(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId LIMIT 10 ``` CPU 사용률이 가장 높은 인스턴스 10개 보기(최댓값을 기준으로 내림차순 정렬) ``` SELECT AVG(CPUUtilization) FROM "AWS/EC2" GROUP BY InstanceId ORDER BY MAX() DESC LIMIT 10 ``` 이 경우 CloudWatch 에이전트가 애플리케이션당 CPU 사용률 지표를 수집합니다. 이 쿼리는 특정 애플리케이션 이름에 대해 해당 지표의 평균을 필터링합니다. ``` SELECT AVG(CPUUtilization) FROM "AWS/CWAgent" WHERE ApplicationName = 'eCommerce' SELECT AVG(ConcurrentExecutions) FROM "AWS/Lambda" ``` 상위 10개 Lambda 함수의 평균 실행 시간 보기(최댓값을 기준으로 내림차순 정렬) ``` SELECT AVG(Duration) FROM "AWS/Lambda" GROUP BY FunctionName ORDER BY MAX() DESC LIMIT 10 ``` Lambda 실행 시간의 평균, 최솟값 및 최댓값 보기 ``` SELECT MAX(Duration) FROM "AWS/Lambda" ``` ### Application Load Balancer 예제 **LoadBalancer** 및 **AvailabilityZone** 차원을 포함하는 지표 보기 ``` SELECT SUM(RequestCount) FROM SCHEMA("AWS/ApplicationELB", LoadBalancer, AvailabilityZone) ``` 활성 동시 TCP 연결 수를 포함하는 지표 보기 ``` SELECT AVG(ActiveConnectionCount) FROM "AWS/ApplicationELB" ``` ### Amazon EBS 예제 볼륨당 상위 10개 평균 쓰기 바이트 보기(내림차순 정렬) ``` SELECT AVG(VolumeWriteBytes) FROM "AWS/EBS" GROUP BY VolumeId ORDER BY MAX() DESC LIMIT 10 ``` 평균 Amazon EBS 볼륨 쓰기 시간 보기 ``` SELECT AVG(VolumeTotalWriteTime) FROM "AWS/EBS" ``` 평균 Amazon EBS 볼륨 유휴 시간 보기 ``` SELECT AVG(VolumeIdleTime) FROM "AWS/EBS" View average burst balance per volume SELECT AVG(BurstBalance) FROM "AWS/EBS" GROUP BY VolumeId View average read bytes across Amazon EBS volumes SELECT AVG(VolumeReadBytes) FROM "AWS/EBS" ``` Amazon EBS 볼륨에서 평균 쓰기 바이트 보기 ``` SELECT AVG(VolumeWriteBytes) FROM "AWS/EBS" ``` ### Amazon Simple Storage Service 예제 버킷 이름별 평균 지연 시간 그룹 보기 ``` SELECT AVG(TotalRequestLatency) FROM "AWS/S3" GROUP BY BucketName ``` 모든 Amazon S3 버킷에서 버킷당 평균 객체 수 보기 ``` SELECT AVG(NumberOfObjects) FROM "AWS/S3" GROUP BY BucketName ``` ### Amazon Simple Notification Service 예제 Amazon-simple-notificaation-service-examples ``` SELECT AVG(NumberOfMessagesPublished) FROM "AWS/SNS" ``` 각 주제 이름에 대해 실패한 평균 메시지 수 보기 ``` SELECT AVG(NumberOfNotificationsFailed) FROM "AWS/SNS" GROUP BY TopicName ``` ### AWS API 사용 예제 계정의 호출 수를 기준으로 상위 20 AWS APIs 보기 ``` SELECT COUNT(CallCount) FROM "AWS/Usage" WHERE "Type" = 'API' GROUP BY "Service", "Resource" ORDER BY SUM() DESC LIMIT 20 ``` ## CloudWatch Metrics Insights 제한 CloudWatch Metrics Insights에는 현재 다음과 같은 제한이 있습니다. + 가장 최근 3시간의 데이터만 쿼리할 수 있습니다. + 단일 쿼리는 10,000개 이하의 지표를 처리할 수 있습니다. 즉, `SELECT`, `FROM`, `WHERE` 절이 10,000개가 넘는 지표와 일치하면 발견된 해당 지표 중 처음 10,000개만 쿼리에 의해 처리됩니다. + 단일 쿼리는 500개 이하의 시계열을 반환할 수 있습니다. 즉, 쿼리에서 500개가 넘는 지표를 반환하는 경우 일부 지표만 쿼리 결과에 반환됩니다. `ORDER BY` 절을 사용하면 처리되는 모든 지표가 정렬되고 `ORDER BY` 절에 따라 내림차순 또는 오름차순으로 500개가 반환됩니다. `ORDER BY` 절을 포함하지 않는 경우 반환되는 500개의 일치하는 지표을 제어할 수 없습니다. + 각 `GetMetricData` 작업에는 쿼리가 하나만 있을 수 있지만 대시보드에는 각 쿼리가 포함된 위젯이 여러 개 있을 수 있습니다. # Amazon CloudWatch Logs 쿼리 편집기 사용 CloudWatch Logs를 쿼리하려면 쿼리할 리전과 최대 20개의 로그 그룹을 선택하세요. 기본 입력 영역을 사용하여 쿼리를 작성합니다. 자세한 내용은 [CloudWatch Logs Insights 쿼리 구문](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html)을 참조하세요. CloudWatch Logs Insights의 `stats` 명령을 사용하여 시계열 데이터를 반환하는 쿼리를 작성할 수도 있습니다. 탐색에서 `stats` 쿼리를 수행할 때 지표 탐색 모드인지 확인해야 합니다. 쿼리 입력 필드 오른쪽에는 쿼리와 함께 CloudWatch Logs Insights 콘솔을 여는 CloudWatch Logs Insights 링크가 있습니다. 필요한 경우 거기에서 계속 탐색할 수 있습니다. ## 템플릿 변수 사용 다른 여러 데이터 소스와 마찬가지로 CloudWatch 데이터 소스는 쿼리에서 템플릿 변수 사용을 지원합니다. 자세한 내용은 [템플릿 및 변수](templates-and-variables.md) 단원을 참조하십시오. ## Grafana 패널에서 CloudWatch Logs 콘솔로 딥링크 연결 CloudWatch Logs Insights 콘솔에서 쿼리를 보려면 쿼리 편집기 옆의 **CloudWatch Logs Insights** 버튼을 선택하세요. 현재 CloudWatch 콘솔에 로그인하지 않은 경우 링크를 누르면 로그인 페이지로 이동합니다. 제공된 링크는 모든에 유효하지 AWS 계정 만 Grafana에서 선택한 데이터 소스에 해당하는에 로그인 AWS 계정 한 경우에만 올바른 지표를 표시합니다. ## 알림 CloudWatch Logs 쿼리는 예를 들어 `stats` 명령을 사용하여 숫자 데이터를 반환할 수 있으므로 알림이 지원됩니다. 자세한 내용은 [Grafana 알림](alerts-overview.md) 단원을 참조하십시오. # 큐레이션된 대시보드 업데이트된 CloudWatch 데이터 소스에는 가장 인기 있는 5가지 AWS 서비스에 대한 사전 구성된 대시보드가 함께 제공됩니다. + Amazon EC2 + Amazon Elastic Block Store + AWS Lambda + Amazon CloudWatch Logs + Amazon Relational Database Service 사전 구성된 대시보드를 가져오려면 CloudWatch 데이터 소스의 구성 페이지로 이동하여 **대시보드** 탭을 선택하세요. 사용하려는 대시보드에 대해 **가져오기**를 선택하세요. 대시보드를 사용자 지정하려면 대시보드를 다른 이름으로 저장하는 것이 좋습니다. 그렇지 않으면 새 버전의 대시보드가 릴리스될 때 대시보드를 덮어씁니다. # 템플릿 기반 쿼리 지표 쿼리에서 서버, 애플리케이션 및 센서 이름과 같은 하드코딩 세부 정보 대신 해당 위치에서 변수를 사용할 수 있습니다. 변수는 대시보드 상단에서 드롭다운 선택 상자로 표시됩니다. 이러한 드롭다운 상자를 사용하여 대시보드에 표시되는 데이터를 변경할 수 있습니다. 템플릿 지정 기능과 다양한 유형의 템플릿 변수에 대한 소개는 [템플릿](templates-and-variables.md#templates) 섹션을 참조하세요. ## 쿼리 변수 CloudWatch 데이터 소스는 **변수** 편집 보기의 **쿼리** 필드에 지정할 수 있는 다음과 같은 쿼리를 제공합니다. 이를 사용하여 변수의 옵션 목록을 `region`, `namespaces`, `metric names`, `dimension keys/values`와 같은 항목으로 채울 수 있습니다. `region` 대신 쿼리의 데이터 소스에 구성된 기본 리전을 사용하도록 `default`를 지정할 수 있습니다. | 이름 | 설명 | | --- | --- | | regions() | 모든 AWS 리전 목록을 반환합니다. | | namespaces() | CloudWatch에서 지원하는 네임스페이스 목록을 반환합니다. | | metrics(namespace, [region]) | 네임스페이스의 지표 목록을 반환합니다. (리전을 지정하거나 사용자 지정 지표에 대해 "default"를 사용합니다.) | | dimension\$1keys(namespace) | 네임스페이스의 차원 키 목록을 반환합니다. | | dimension\$1values(region, namespace, metric, dimension\$1key, [filters]) | 지정된 region, namespace, metric 또는 dimension\$1key와 일치하는 차원 값 목록을 반환합니다. 또는 filters 차원을 사용하여 더 구체적인 결과를 얻을 수 있습니다. | | ebs\$1volume\$1ids(region, instance\$1id) | 지정된 region, instance\$1id와 일치하는 볼륨 ID 목록을 반환합니다. | | ec2\$1instance\$1attribute(region, attribute\$1name, filters) | 지정된 region, attribute\$1name, filters와 일치하는 속성 목록을 반환합니다. | | resource\$1arns(region, resource\$1type, tags) | 지정된 region, resource\$1type 및 tags와 일치하는 ARN 목록을 반환합니다. | | statistics() | 모든 표준 통계 목록을 반환합니다. | CloudWatch에서 제공하는 지표에 대한 자세한 내용은 [AWS CloudWatch 지표를 게시하는 서비스](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/aws-services-cloudwatch-metrics.html)를 참조하세요. ### 템플릿 기반 쿼리 예제 다음 표에는 개별 AWS 서비스에 대한 리소스 목록을 반환하는 차원 쿼리의 예가 나와 있습니다. | Query | 서비스 | | --- | --- | | dimension\$1values(us-east-1,AWS/ELB,RequestCount,LoadBalancerName) | Elastic Load Balancing | | dimension\$1values(us-east-1,AWS/ElastiCache,CPUUtilization,CacheClusterId) | Amazon ElastiCache | | dimension\$1values(us-east-1,AWS/Redshift,CPUUtilization,ClusterIdentifier) | Amazon Redshift | | dimension\$1values(us-east-1,AWS/RDS,CPUUtilization,DBInstanceIdentifier) | Amazon RDS | | dimension\$1values(us-east-1,AWS/S3,BucketSizeBytes,BucketName) | Amazon Simple Storage Service(Amazon S3) | | dimension\$1values(us-east-1,CWAgent,disk\$1used\$1percent,device,\$1"InstanceId":"\$1instance\$1id"\$1) | CloudWatch 에이전트 | | resource\$1arns(eu-west-1,elasticloadbalancing:loadbalancer,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1) | Elastic Load Balancing | | resource\$1arns(eu-west-1,ec2:instance,\$1"elasticbeanstalk:environment-name":["myApp-dev","myApp-prod"]\$1) | Amazon EC2 | # ec2\$1instance\$1attribute 예제 사용 ## JSON 필터 `ec2_instance_attribute` 쿼리는 JSON 형식으로 `filters`를 사용합니다. `ec2:DescribeInstances`의 사전 정의된 필터를 지정할 수 있습니다. 실제 필터링은 Grafana가 AWS아닌에서 이루어집니다. 다음 코드 예제에서는 필드 구문을 보여줍니다. ``` { filter_name1: [ filter_value1 ], filter_name2: [ filter_value2 ] } ``` 다음 예제에서는 `ec2_instance_attribute()` 쿼리를 보여줍니다. ``` ec2_instance_attribute(us - east - 1, InstanceId, { 'tag:Environment': ['production'] }); ``` ## 속성 선택 인스턴스당 하나의 속성만 반환할 수 있습니다. 모든 플랫 속성을 선택할 수 있습니다(즉, 속성에 단일 값이 있고 객체나 배열이 아닌 경우). 다음 플랫 속성을 사용할 수 있습니다. + `AmiLaunchIndex` + `Architecture` + `ClientToken` + `EbsOptimized` + `EnaSupport` + `Hypervisor` + `IamInstanceProfile` + `ImageId` + `InstanceId` + `InstanceLifecycle` + `InstanceType` + `KernelId` + `KeyName` + `LaunchTime` + `Platform` + `PrivateDnsName` + `PrivateIpAddress` + `PublicDnsName` + `PublicIpAddress` + `RamdiskId` + `RootDeviceName` + `RootDeviceType` + `SourceDestCheck` + `SpotInstanceRequestId` + `SriovNetSupport` + `SubnetId` + `VirtualizationType` + `VpcId` 태그 이름에 `Tags`를 접두사를 지정하여 태그를 선택할 수 있습니다. 다음 예제에서는 `ec2_instance_attribute()` 쿼리를 보여줍니다. ``` ec2_instance_attribute(us - east - 1, Tags.Name, { 'tag:Team': ['sysops'] }); ``` # JSON 형식 템플릿 변수 사용 일부 쿼리는 JSON 형식의 필터를 수락하며, Grafana는 JSON으로의 템플릿 변수 변환을 지원합니다. `env = 'production', 'staging'`인 경우 다음 쿼리는 `Environment` 태그가 `production` 또는 `staging`인 EC2 인스턴스의 ARN을 반환합니다. ``` resource_arns(us-east-1, ec2:instance, {"Environment":${env:json}}) ``` # 가격 책정 Grafana에 대한 Amazon CloudWatch 데이터 소스에서는 `ListMetrics` 및 `GetMetricData` CloudWatch API 직접 호출을 사용하여 지표를 나열하고 검색합니다. CloudWatch Logs 요금은 CloudWatch Logs Insights 쿼리를 통해 수집, 아카이브 및 분석되는 데이터의 양에 기반합니다. 자세한 내용은 [Amazon CloudWatch 요금](https://aws.amazon.com/cloudwatch/pricing)을 참조하세요. 쿼리 편집기에서 차원을 선택할 때마다 Grafana는 `ListMetrics` 요청을 실행합니다. 쿼리 편집기에서 쿼리를 변경할 때마다 GetMetricData에 대한 하나의 새 요청이 실행됩니다. 데이터 샘플을 검색하기 위한 API 요청에서는 `GetMetricData` 작업을 사용합니다. 이 작업은 CloudWatch 지표 수학을 보다 효과적으로 지원합니다. 또한 와일드카드 문자를 사용하거나 **정확히 일치** 옵션을 끌 때 검색 표현식의 자동 생성도 지원합니다. `GetMetricData` 작업에서는 요금이 발생합니다. 자세한 내용은 [Amazon CloudWatch 요금](https://aws.amazon.com/cloudwatch/pricing)을 참조하세요. # Service Quotas AWS 는 AWS 계정의 리소스, 작업 및 항목에 대한 할당량 또는 제한을 정의합니다. 대시보드의 쿼리 수와 대시보드에 액세스하는 사용자 수에 따라 다양한 CloudWatch 및 CloudWatch Logs 리소스의 사용 제한에 도달할 수 있습니다. 할당량은 계정 및 AWS 리전별로 정의됩니다. 여러 리전을 사용 중이거나 여러 계정에 대해 쿼리할 CloudWatch 데이터 소스를 두 개 이상 설정한 경우 제한에 도달한 각 계정 및 각 리전에 대해 할당량 증가를 요청해야 합니다. 자세한 내용은 [CloudWatch 서비스 할당량](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/cloudwatch_limits.html)을 참조하세요. # 교차 계정 관찰성 **주의** 이 기능을 사용하려면 Grafana 워크스페이스가 버전 9 이상이어야 합니다. CloudWatch 플러그인을 사용하면 여러 리전 계정에서 애플리케이션을 모니터링하고 문제를 해결할 수 있습니다. 교차 계정 관찰성을 사용하면 계정 경계에 대한 걱정을 하지 않고도 지표 및 로그를 원활하게 검색, 시각화 및 분석할 수 있습니다. 교차 계정 관찰성을 활성화하려면 먼저 CloudWatch에서 이 기능을 활성화한 다음, 플러그인을 실행하는 역할/사용자에 적절한 IAM 작업을 추가합니다. Amazon Managed Grafana 워크스페이스가 VPC 내에서 실행 중인 경우 인터넷 액세스를 지원하는 NAT 게이트웨이도 있어야 합니다. + 기능을 활성화하는 방법을 알아보려면 *Amazon CloudWatch 사용 설명서*의 [CloudWatch cross-account observability](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html)를 참조하세요. + 다음 작업은 플러그인을 실행하는 역할/사용자에 대해 추가할 적절한 IAM 작업입니다. ``` { "Sid": "AllowReadingAcrossAccounts", "Effect": "Allow", "Action": [ "oam:ListSinks", "oam:ListAttachedLinks" ], "Resource": "*" } ``` + CloudWatch 데이터 소스에 대한 교차 계정 관찰성은 Amazon CloudWatch Observability Access Manager를 사용합니다. Observability Access Manager는 VPC 엔드포인트를 지원하지 않습니다. Amazon Managed Grafana 워크스페이스가 VPC 내에서 실행 중인 경우 워크스페이스가 인터넷에서 API를 직접 호출하도록 허용하는 NAT 게이트웨이도 있어야 합니다. **참고** 액세스하려는 계정의 CloudWatch 데이터를 읽을 수 있는 IAM 권한도 있어야 합니다.