기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CloudWatch Logs에 대한 자격 증명 기반 정책(IAM 정책) 사용

이 항목에서는 계정 관리자가 IAM ID(사용자, 그룹, 역할)에 권한 정책을 연결할 수 있는 ID 기반 정책의 예를 제공합니다.

이 주제는 다음을 다룹니다.

다음은 권한 정책의 예제입니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents",
        "logs:DescribeLogStreams"
    ],
      "Resource": [
        "arn:aws:logs:*:*:*"
    ]
  }
 ]
}

이 정책에는 로그 그룹 및 로그 스트림을 생성하고 로그 스트림에 로그 이벤트를 업로드하며 로그 스트림에 대한 세부 사항을 나열할 수 있는 권한을 부여하는 명령문이 하나 포함되어 있습니다.

Resource 값 끝에 와일드카드 문자(*)가 있다는 것은 이 정책 명령문이 어떤 로그 그룹에서든 logs:CreateLogGroup, logs:CreateLogStream, logs:PutLogEvents 및 logs:DescribeLogStreams 작업에 대한 권한을 허용한다는 의미입니다. 이러한 권한을 특정 로그 그룹으로 제한하려면 리소스 ARN에 있는 와일드카드 문자(*)를 특정 로그 그룹 ARN으로 대체합니다. IAM 정책 설명 내 섹션에 대한 자세한 내용은 IAM 사용 설명서의 IAM 정책 요소 참조를 참조하세요. 모든 CloudWatch Logs 작업을 보여주는 목록은 CloudWatch Logs 권한 참조 섹션을 참조하세요.

CloudWatch 콘솔을 사용하는 데 필요한 권한

사용자가 CloudWatch 콘솔에서 CloudWatch Logs로 작업하려면 해당 사용자에게 AWS 계정의 다른 AWS 리소스를 설명할 수 있는 최소 권한 집합이 있어야 합니다. CloudWatch 콘솔에서 CloudWatch Logs를 사용하려면 다음 서비스에서도 권한이 있어야 합니다.

최소 필수 권한보다 더 제한적인 IAM 정책을 만들면 콘솔은 해당 IAM 정책에 연결된 사용자에 대해 의도대로 작동하지 않습니다. 해당 사용자가 CloudWatch 콘솔을 계속 사용할 수 있도록 하려면 AWS CloudWatch Logs에 대한 관리형(미리 정의된) 정책 단원에 설명된 대로 CloudWatchReadOnlyAccess 관리형 정책도 사용자에게 연결해야 합니다.

AWS CLI 또는 CloudWatch Logs API만 호출하는 사용자에게는 최소 콘솔 권한을 허용할 필요가 없습니다.

CloudWatch 콘솔을 사용하여 로그 구독을 관리하지 않는 사용자가 콘솔에서 작업하는 데 필요한 권한의 전체 집합은 다음과 같습니다.

사용자가 콘솔을 사용하여 로그 구독도 관리할 경우 다음 권한도 필요합니다.

AWS CloudWatch Logs에 대한 관리형(미리 정의된) 정책

AWS 는에서 생성하고 관리하는 독립 실행형 IAM 정책을 제공하여 많은 일반적인 사용 사례를 처리합니다 AWS. 관리형 정책은 사용자가 필요한 권한을 조사할 필요가 없도록 일반 사용 사례에 필요한 권한을 부여합니다. 자세한 내용은 IAM 사용 설명서의 AWS 관리형 정책을 참조하세요.

계정의 사용자 및 역할에 연결할 수 있는 다음 AWS 관리형 정책은 CloudWatch Logs에 고유합니다.

CloudWatchLogsFullAccess

CloudWatchLogsFullAccess 정책은 CloudWatch Logs에 대한 전체 액세스 권한을 부여합니다. 정책에는 cloudwatch:GenerateQuery 및 cloudwatch:GenerateQueryResultsSummary 권한이 포함되어 있으므로이 정책을 사용하는 사용자는 자연어 프롬프트에서 CloudWatch Logs Insights 쿼리 문자열을 생성할 수 있습니다. 정책의 전체 내용을 보려면 AWS 관리형 정책 참조 안내서의 CloudWatchLogsFullAccess를 참조하세요.

CloudWatchLogsReadOnlyAccess

CloudWatchLogsReadOnlyAccess 정책은 CloudWatch Logs에 대한 읽기 전용 액세스 권한을 부여합니다. 여기에는 cloudwatch:GenerateQuery 및 cloudwatch:GenerateQueryResultsSummary 권한이 포함되어 있으므로이 정책을 사용하는 사용자는 자연어 프롬프트에서 CloudWatch Logs Insights 쿼리 문자열을 생성할 수 있습니다. 정책의 전체 내용을 보려면 AWS 관리형 정책 참조 안내서의 CloudWatchLogsReadOnlyAccess를 참조하세요.

CloudWatchOpenSearchDashboardsFullAccess

CloudWatchOpenSearchDashboardsFullAccess 정책은 OpenSearch Service와의 통합을 생성, 관리 및 삭제하고 해당 통합에서 벤딩된 로그 대시보드를 생성 및 관리할 수 있는 액세스 권한을 부여합니다. 자세한 내용은 Amazon OpenSearch Service로 분석 단원을 참조하십시오.

정책의 전체 내용을 보려면 AWS 관리형 정책 참조 안내서의 CloudWatchOpenSearchDashboardsFullAccess를 참조하세요.

CloudWatchOpenSearchDashboardAccess

CloudWatchOpenSearchDashboardAccess 정책은 Amazon OpenSearch Service 분석으로 생성된 판매 로그 대시보드를 볼 수 있는 액세스 권한을 부여합니다. 자세한 내용은 Amazon OpenSearch Service로 분석 단원을 참조하십시오.

정책의 전체 내용을 보려면 AWS 관리형 정책 참조 안내서의 CloudWatchOpenSearchDashboardAccess를 참조하세요.

CloudWatchLogsCrossAccountSharingConfiguration

CloudWatchLogsCrossAccountSharingConfiguration 정책은 계정 간에 CloudWatch Logs 리소스를 공유하기 위해 Observability Access Manager 링크를 생성 및 관리하고 볼 수 있는 액세스 권한을 부여합니다. 자세한 내용은 CloudWatch 교차 계정 관측성을 참조하세요.

정책의 전체 내용을 보려면 AWS 관리형 정책 참조 안내서의 CloudWatchLogsCrossAccountSharingConfiguration을 참조하세요.

AWS 관리형 정책에 대한 CloudWatch Logs 업데이트

이 서비스가 이러한 변경 사항을 추적하기 시작한 이후부터 CloudWatch Logs의 AWS 관리형 정책 업데이트에 대한 세부 정보를 봅니다. 이 페이지의 변경 사항에 대한 자동 알림을 받아보려면 CloudWatch Logs 문서 기록 페이지에서 RSS 피드를 구독하세요.

고객 관리형 정책 예

CloudWatch Logs 작업 및 리소스에 대한 권한을 허용하는 고유의 사용자 지정 IAM 정책을 생성할 수도 있습니다. 해당 권한이 필요한 사용자 또는 그룹에 이러한 사용자 지정 정책을 연결할 수 있습니다.

이 섹션에서는 다양한 CloudWatch Logs 작업에 대한 권한을 부여하는 사용자 정책의 예를 제공합니다. 이러한 정책은 CloudWatch Logs API, AWS SDK 또는 AWS CLI를 사용하는 경우에 유효합니다.

예제 1: CloudWatch Logs에 대한 전체 액세스 허용

다음 정책은 사용자가 모든 CloudWatch Logs 작업에 액세스할 수 있도록 허용합니다.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "logs:*"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

예제 2: CloudWatch Logs에 대한 읽기 전용 액세스 허용

AWS 는 CloudWatch Logs 데이터에 대한 읽기 전용 액세스를 활성화하는 CloudWatchLogsReadOnlyAccess 정책을 제공합니다. CloudWatch 이 정책에는 다음 권한이 포함되어 있습니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "logs:Describe*",
                "logs:Get*",
                "logs:List*",
                "logs:StartQuery",
                "logs:StopQuery",
                "logs:TestMetricFilter",
                "logs:FilterLogEvents",
                "logs:StartLiveTail",
                "logs:StopLiveTail",
                "cloudwatch:GenerateQuery"
            ],
            "Effect": "Allow",
            "Resource": "*"
        }
    ]
}

예제 3: 로그 그룹 하나에 대한 액세스 허용

다음 정책에서는 사용자가 지정된 로그 그룹 하나에서 로그 이벤트를 읽고 쓸 수 있게 허용합니다.

{
   "Version":"2012-10-17",
   "Statement":[
      {
      "Action": [
        "logs:CreateLogStream",
        "logs:DescribeLogStreams",
        "logs:PutLogEvents",
        "logs:GetLogEvents"
      ],
      "Effect": "Allow",
      "Resource": "arn:aws:logs:us-west-2:123456789012:log-group:SampleLogGroupName:*"
      }
   ]
}

로그 그룹 수준의 제어를 위한 태깅 및 IAM 정책 사용

사용자에게 특정 로그 그룹에 대한 액세스 권한을 부여함과 동시에 다른 로그 그룹에 대한 액세스를 방지할 수 있습니다. 이렇게 하려면 로그 그룹에 태그를 지정하고 해당 태그를 참조하는 IAM 정책을 사용하세요. 로그 그룹에 태그를 적용하려면 logs:TagResource 또는 logs:TagLogGroup 권한이 있어야 합니다. 이는 로그 그룹을 생성할 때 로그 그룹에 태그를 할당하거나 나중에 할당하는 경우 모두에 적용됩니다.

로그 그룹의 태깅에 대한 자세한 내용은 Amazon CloudWatch Logs의 로그 그룹에 태그 지정 섹션을 참조하세요.

로그 그룹에 태그를 지정할 때 특정 태그가 있는 로그 그룹에만 액세스를 허용할 수 있도록 사용자에게 IAM 정책에 대한 권한을 부여할 수 있습니다. 예를 들어, 다음 정책 명령문은 태그 키 Team에 대한 값이 Green인 로그 그룹에만 액세스하도록 권한을 부여합니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "logs:*"
            ],
            "Effect": "Allow",
            "Resource": "*",
            "Condition": {
                "StringLike": {
                    "aws:ResourceTag/Team": "Green"
                }
            }
        }
    ]
}

StopQuery 및 StopLiveTail API 작업은 기존 방식으로 AWS 리소스와 상호 작용하지 않습니다. 즉, 어떤 식으로든 데이터를 반환하거나 데이터를 넣거나 리소스를 수정하지 않습니다. 대신, 리소스로 분류되지 않는 지정된 Live Tail 세션 또는 지정된 CloudWatch 로그 인사이트 쿼리에서만 작동합니다. 따라서 이러한 작업에 대해 IAM 정책에서 Resource 필드를 지정하는 경우 다음 예제와 같이 Resource 필드 값을 *로 설정해야 합니다.

{
    "Version": "2012-10-17", 
    "Statement": 
        [ {
            "Effect": "Allow", 
            "Action": [ 
                "logs:StopQuery",
                "logs:StopLiveTail"
            ], 
            "Resource": "*" 
            } 
        ] 
}

IAM 정책에 자세한 내용은 IAM 사용 설명서에서 정책을 사용하여 액세스 제어를 참조하세요.