자습서: 샘플 쿼리 실행 및 수정 - Amazon CloudWatch Logs

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

자습서: 샘플 쿼리 실행 및 수정

다음 자습서는 CloudWatch Logs Insights를 시작하는 데 도움이 됩니다. 샘플 쿼리를 실행한 다음 수정해 다시 실행하는 방법을 살펴봅니다.

쿼리를 실행하려면 로그에 CloudWatch 로그가 이미 저장되어 있어야 합니다. 이미 CloudWatch 로그를 사용하고 있고 로그 그룹과 로그 스트림이 설정된 경우 시작할 준비가 된 것입니다. AWS CloudTrail, Amazon Route 53 또는 AmazonVPC과 같은 서비스를 사용하고 해당 서비스의 로그를 로그로 이동하도록 설정한 경우에도 CloudWatch 이미 로그가 있을 수 있습니다. CloudWatch 로그로 로그를 전송하는 방법에 대한 자세한 내용은 섹션을 참조하세요CloudWatch Logs 시작하기.

CloudWatch Logs Insights의 쿼리는 로그 이벤트의 필드 세트 또는 로그 이벤트에 대해 수행된 수학적 집계 또는 기타 작업의 결과를 반환합니다. 이 자습서에서는 로그 이벤트 목록을 반환하는 쿼리를 보여줍니다.

샘플 쿼리 실행

CloudWatch Logs Insights 샘플 쿼리를 실행하려면
  1. 에서 CloudWatch 콘솔을 엽니다https://console.aws.amazon.com/cloudwatch/.

  2. 탐색 창에서 로그(Logs)를 선택한 다음, 로그 인사이트(Logs Insights)를 선택합니다.

    로그 인사이트 페이지의 쿼리 편집기에는 최신 로그 이벤트 20개를 반환하는 기본 쿼리가 포함되어 있습니다.

  3. 로그 그룹 선택(Select log group(s)) 드롭다운에서 쿼리할 로그 그룹을 하나 이상 선택합니다.

    CloudWatch 교차 계정 관찰이 가능한 모니터링 계정인 경우 소스 계정과 모니터링 계정에서 로그 그룹을 선택할 수 있습니다. 하나의 쿼리로 다른 계정의 로그를 한 번에 쿼리할 수 있습니다.

    로그 그룹 이름, 계정 ID 또는 계정 레이블을 기준으로 로그 그룹을 필터링할 수 있습니다.

    표준 로그 클래스에서 로그 그룹을 선택하면 CloudWatch Logs Insights가 그룹의 데이터 필드를 자동으로 감지합니다. 검색된 필드를 보려면 페이지 오른쪽 상단의 필드(Fields) 메뉴를 선택합니다.

    참고

    검색된 필드는 Standard 로그 클래스의 로그 그룹에 대해서만 지원됩니다. 로그 클래스에 대한 자세한 내용은 로그 클래스를 참조하세요.

  4. (선택 사항) 시간 간격 선택기를 사용하여 쿼리할 기간을 선택합니다.

    5~30분 간격, 1, 3, 12시간 간격 또는 사용자 지정 시간 범위 중에서 선택할 수 있습니다.

  5. 실행(Run)을 선택하고 결과를 봅니다.

    이 자습서에서는 가장 최근에 추가된 로그 이벤트 20개가 결과에 포함되어 있습니다.

    CloudWatch Logs는 시간 경과에 따른 로그 그룹의 로그 이벤트 막대 그래프를 표시합니다. 이 막대 그래프는 테이블의 이벤트뿐만 아니라 쿼리 및 시간 범위와 일치하는 로그 그룹 내 이벤트의 분포를 보여줍니다.

  6. 반환된 로그 이벤트의 모든 필드를 보려면 번호가 매겨진 이벤트의 왼쪽에 있는 삼각형 드롭다운 아이콘을 선택합니다.

샘플 쿼리 수정

이 자습서에서는 최신 로그 이벤트 50개를 표시하도록 샘플 쿼리를 수정합니다.

이전 자습서를 아직 실행하지 않은 경우 지금 실행하는 것이 좋습니다. 이 자습서에는 이전 자습서를 마친 지점에서 시작합니다.

참고

CloudWatch Logs Insights와 함께 제공되는 일부 샘플 쿼리는 대신 head 또는 tail 명령을 사용합니다limit. 이러한 명령은 더 이상 사용되지 않으며 limit로 대체되었습니다. 작성하는 모든 쿼리에 head 또는 tail 대신 limit를 사용합니다.

CloudWatch Logs Insights 샘플 쿼리를 수정하려면
  1. 쿼리 편집기에서 2050으로 변경한 다음 실행을 선택합니다.

    새 쿼리의 결과가 표시됩니다. 기본 시간 범위 내에서 로그 파일에 데이터가 충분하다고 가정하고 이제 로그 이벤트 50개가 나열됩니다.

  2. (선택 사항) 생성한 쿼리를 저장할 수 있습니다. 이 쿼리를 저장하려면 저장을 선택합니다. 자세한 정보는 CloudWatch Logs Insights 쿼리 저장 및 재실행 섹션을 참조하세요.

샘플 쿼리에 필터 명령 추가

이 자습서에서는 쿼리 편집기에서 쿼리를 보다 과감하게 변경하는 방법에 대해 살펴봅니다. 이 자습서에서는 검색된 로그 이벤트의 필드를 기반으로 이전 쿼리의 결과를 필터링합니다.

이전 자습서를 아직 실행하지 않은 경우 지금 실행하는 것이 좋습니다. 이 자습서에는 이전 자습서를 마친 지점에서 시작합니다.

이전 쿼리에 필터 명령을 추가하려면
  1. 필터링할 필드를 결정합니다. 지난 15분 동안 선택한 CloudWatch 로그 그룹에 포함된 로그 이벤트에서 로그가 감지한 가장 일반적인 필드와 각 필드가 표시되는 로그 이벤트의 백분율을 보려면 페이지 오른쪽의 필드를 선택합니다.

    특정 로그 이벤트에 포함된 필드를 확인하려면 해당 행 왼쪽에 있는 아이콘을 선택합니다.

    로그에 있는 이벤트에 따라 로그 이벤트에 awsRegion 필드가 표시될 수 있습니다. 이 자습서의 나머지 부분에서는 를 필터 필드awsRegion로 사용하지만 해당 필드를 사용할 수 없는 경우 다른 필드를 사용할 수 있습니다.

  2. 쿼리 편집기 상자에서 50 뒤에 커서를 놓고 Enter를 누릅니다.

  3. 새 줄에 먼저 |(파이프 문자)와 공백을 입력합니다. CloudWatch Logs Insights 쿼리의 명령은 파이프 문자로 구분해야 합니다.

  4. filter awsRegion="us-east-1"을 입력합니다.

  5. Run(실행)을 선택합니다.

    다시 쿼리를 실행하면 이제 새 필터와 일치하는 최신 결과 50개가 표시됩니다.

    다른 필드를 필터링했는데 오류 결과가 표시되면 해당 필드 이름을 이스케이프해야 할 수 있습니다. 필드 이름에 영숫자가 아닌 문자가 포함되어 있으면 필드 이름의 앞/뒤에 백틱 문자(`)를 입력해야 합니다(예: `error-code`="102").

    영숫자가 아닌 문자를 포함하는 필드 이름에 백틱 문자를 사용해야 하지만 값은 그렇지 않습니다. 값은 항상 따옴표(") 안에 포함됩니다.

CloudWatch Logs Insights에는 정규식, 수학 및 통계 작업에 대한 여러 명령 및 지원을 포함한 강력한 쿼리 기능이 포함되어 있습니다. 자세한 내용은 CloudWatch Logs Insights 쿼리 구문 단원을 참조하십시오.