CloudWatch 문제 해결agent - Amazon CloudWatch

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

CloudWatch 문제 해결agent

다음 정보를 사용하면 CloudWatch 에이전트의 문제를 해결하는 데 도움이 됩니다.

CloudWatcha젠트c옴난드lineparameters

CloudWatch 에이전트가 지원하는 전체 파라미터 목록을 보려면 설치되어 있는 컴퓨터의 명령줄에 다음과 같이 입력합니다.

amazon-cloudwatch-agent-ctl -help

CloudWatch 설치a젠트uRun Commandfails

Systems Manager 실행 명령을 사용하여 CloudWatch 에이전트를 설치하려면 대상 서버의 SSM 에이전트가 2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2.2. SSM 에이전트가 올바른 버전이 아닌 경우 다음 메시지가 포함된 오류가 표시될 수 있습니다.

no latest version found for package AmazonCloudWatchAgent on platform linux
failed to download installation package reliably

SSM 에이전트 버전 업데이트에 대한 자세한 내용은 단원을 참조하십시오.SSM 에이전트 설치 및 구성AWS Systems Manager사용 설명서.

CloudWatch 더a젠트w에 없음start

CloudWatch 에이전트가 시작되지 않는 경우 구성에 문제가 있을 수 있습니다. 구성 정보는 configuration-validation.log 파일에 기록됩니다. 이 파일은 Linux 서버의 /opt/aws/amazon-cloudwatch-agent/logs/configuration-validation.log 및 Windows Server가 실행되는 서버의 $Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\configuration-validation.log에 있습니다.

확인t모자 더 CloudWatcha젠트isrunning

CloudWatch 에이전트를 쿼리하여 해당 에이전트가 실행 중인지 아니면 중지되었는지를 확인할 수 있습니다. AWS Systems Manager를 사용하면 이 작업을 원격으로 수행할 수 있습니다. 명령줄을 사용할 수도 있지만, 로컬 서버를 확인하기 위해서만 사용해야 합니다.

명령 실행을 사용하여 CloudWatch 에이전트의 상태를 쿼리하려면

  1. Systems Manager 콘솔을 엽니다.https://console.aws.amazon.com/systems-manager/.

  2. 탐색 창에서 Run Command를 선택합니다.

    -또는-

    만약AWS Systems Manager홈페이지가 열리면, 아래로 스크롤하고Expland 실행.

  3. Run 명령을 선택합니다.

  4. 명령 문서 목록에서 AmazonCloudWatch-ManageAgent 옆의 버튼을 선택합니다.

  5. 작업 목록에서 상태를 선택합니다.

  6. Optional Configuration Source(구성 소스(선택 사항))에 대해 기본값을 선택하고 Optional Configuration Location(구성 위치(선택 사항))을 비워 둡니다.

  7. 대상 영역에서 확인할 인스턴스를 선택합니다.

  8. 실행을 선택합니다.

에이전트가 실행 중인 경우 결과가 다음과 유사하게 표시됩니다.

{ "status": "running", "starttime": "2017-12-12T18:41:18", "version": "1.73.4" }

에이전트가 중지된 경우 "status" 필드에 "stopped"가 표시됩니다.

명령줄을 사용하여 CloudWatch 에이전트의 상태를 로컬에서 쿼리하려면

  • Linux 서버의 경우 다음을 입력합니다.

    sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -m ec2 -a status

    Windows Server가 실행되는 서버의 경우 관리자로서 PowerShell에 다음을 입력합니다.

    & $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a status

CloudWatch 더a젠트w에 없음s타르트, 그리고eRRORmAmazon EC2 리전을 등록합니다.

에이전트가 시작되지 않고 오류 메시지에 Amazon EC2 리전 엔드포인트가 언급되어 있으면 액세스 권한을 부여하지 않고 Amazon EC2 엔드포인트에 액세스해야 하도록 에이전트를 구성했을 수 있습니다.

예를 들어, 에 값을 지정한 경우append_dimensions파라미터를 사용하고 프록시를 사용할 경우 서버에서 Amazon EC2 엔드포인트에 액세스할 수 있어야 합니다. 이러한 엔드포인트에 대한 자세한 내용은 단원을 참조하십시오.Amazon Elastic Compute Cloud (Amazon EC2)Amazon Web Services 일반 참조.

CloudWatch 더a젠트w에 없음sWindows Server의 타트

Windows Server에서는수도 있습니다다음 오류를 참조하십시오.

Start-Service : Service 'Amazon CloudWatch Agent (AmazonCloudWatchAgent)' cannot be started due to the following error: Cannot start service AmazonCloudWatchAgent on computer '.'. At C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1:113 char:12 + $svc | Start-Service + ~~~~~~~~~~~~~ + CategoryInfo : OpenError: (System.ServiceProcess.ServiceController:ServiceController) [Start-Service], ServiceCommandException + FullyQualifiedErrorId : CouldNotStartService,Microsoft.PowerShell.Commands.StartServiceCommand

이 문제를 해결하려면 먼저 서버 서비스가 실행 중인지 확인하십시오. 서버 서비스가 실행되고 있지 않을 때 에이전트가 시작하려고 하면 이 오류가 나타날 수 있습니다.

서버 서비스가 이미 실행 중인 경우 다음 문제가 될 수 있습니다. 경우에 따라 Windows Server에 설치된 CloudWatch 에이전트를 시작하는 데 30초 넘게 걸립니다. Windows Server는 기본적으로 서비스를 시작하는 데 30초만 허용하므로 다음과 유사한 오류가 발생하며 에이전트가 시작되지 않습니다.

이 문제를 해결하려면 서비스 시간 초과 값을 늘리십시오. 자세한 내용은 서비스가 시작되지 않으며 Windows 이벤트 로그에 이벤트 7000 및 7011이 기록됨을 참조하십시오.

다음을 수행할 수 없음f공업cWindows Server의 Redentity

Windows 서버에서 다른 위치에 자격 증명이 있는 경우$SystemDrive\\Users\\Administrator\\.awsWindows Server 2012에 설치하거나“$SystemDrive\\Documents and Settings\\Administrator\\.aws를 사용 하 여 사용자 자신의 자격 증명 경로를 지정할 수 있습니다shared_credential_file옵션에서common.toml.

자격 증명 파일이 없는 경우 만들어야 합니다. 자세한 정보는 (선택 사항)c오몬c에 대한 구성pRoxy 또는 Regioninformation을 참조하십시오.

여기서 각a를 다시m에트릭스?

CloudWatch 에이전트가 실행 중이지만 이 에이전트에 의해 수집된 지표를AWS Management Console또는AWS CLI에서 올바른 네임스페이스를 사용하고 있는지 확인합니다. 기본적으로 에이전트에 의해 수집되는 지표의 네임스페이스는 CWAgent입니다. 에이전트 구성 파일의 metrics 섹션에 있는 namespace 필드를 사용하여 이 네임스페이스를 사용자 지정할 수 있습니다. 원하는 지표가 표시되지 않는 경우 구성 파일을 점검하여 사용 중인 네임스페이스를 확인하십시오.

CloudWatch 에이전트 패키지를 처음 다운로드하는 경우 에이전트 구성 파일은amazon-cloudwatch-agent.json. 이 파일은 구성 마법사를 실행한 디렉터리에 있습니다. 그렇지 않으면 이 파일을 다른 디렉터리로 옮긴 것일 수 있습니다. 구성 마법사를 사용하는 경우, 마법사의 에이전트 구성 파일 출력이 config.json으로 명명됩니다. namespace 필드를 포함한 구성 파일에 대한 자세한 내용은 CloudWatcha젠트c분류: 상상file 지표section 단원을 참조하십시오.

에이전트 구성을 업데이트했지만 CloudWatch 콘솔에 새 지표 또는 로그가 표시되지 않습니다.

CloudWatch 에이전트 구성 파일을 업데이트하는 경우 다음에 에이전트를 시작할 때fetch-config옵션을 클릭합니다. 예를 들어 로컬 컴퓨터에 업데이트된 파일을 저장한 경우 다음 명령을 입력합니다.

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a fetch-config -s -m ec2 -c file:configuration-file-path

CloudWatcha젠트files 및locations

다음 표에는 CloudWatch 에이전트에 의해 설치되고 사용되는 파일과 Linux 또는 Windows 서버를 실행하는 서버에서의 위치 목록이 나와 있습니다.

파일 LinuxL분류: 과양 Windows ServerL분류: 과양

에이전트의 시작, 중지 및 재시작을 제어하는 제어 스크립트입니다.

/opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl 또는 /usr/bin/amazon-cloudwatch-agent-ctl

$Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1

에이전트가 작성하는 로그 파일입니다. AWS Support에 문의할 경우 이 파일을 첨부해야 할 수도 있습니다.

/opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log 또는 /var/log/amazon/amazon-cloudwatch-agent/amazon-cloudwatch-agent.log

$Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\amazon-cloudwatch-agent.log

에이전트 구성 검증 파일입니다.

/opt/aws/amazon-cloudwatch-agent/logs/configuration-validation.log 또는 /var/log/amazon/amazon-cloudwatch-agent/configuration-validation.log

$Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\configuration-validation.log

마법사가 에이전트를 생성한 직후에 에이전트를 구성할 때 사용되는 JSON 파일입니다. 자세한 정보는 CloudWatch 생성a젠트c분류: 상상file을 참조하십시오.

/opt/aws/amazon-cloudwatch-agent/bin/config.json

$Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\config.json

이 구성 파일을 매개 변수 저장소에서 다운로드한 경우 에이전트를 구성하는 데 사용되는 JSON 파일입니다.

/opt/aws/amazon-cloudwatch-agent/etc/amazon-cloudwatch-agent.json 또는 /etc/amazon/amazon-cloudwatch-agent/amazon-cloudwatch-agent.json

$Env:ProgramData\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent.json

에이전트가 사용할 리전 및 자격 증명 정보를 지정하는 데 사용되는 TOML 파일이며 시스템 기본값은 무시됩니다.

/opt/aws/amazon-cloudwatch-agent/etc/common-config.toml 또는 /etc/amazon/amazon-cloudwatch-agent/common-config.toml

$Env:ProgramData\Amazon\AmazonCloudWatchAgent\common-config.toml

CloudWatch 에이전트 버전에 대한 정보 찾기

Linux 서버에서 CloudWatch 에이전트의 버전 번호를 찾으려면 다음 명령을 입력합니다.

sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -a status

Windows Server에서 CloudWatch 에이전트의 버전 번호를 찾으려면 다음 명령을 입력합니다.

& $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a status
참고

이 명령을 사용하면 CloudWatch 에이전트의 버전을 올바르게 찾을 수 있습니다. 사용하는 경우프로그램 및 특징제어판에 잘못된 버전 번호가 표시됩니다.

또한 에이전트의 최신 변경 사항에 대한 README 파일과 현재 다운로드할 수 있는 버전 번호를 나타내는 파일을 다운로드할 수 있습니다. 이러한 파일은 다음 위치에 있습니다.

  • https://s3.amazonaws.com/amazoncloudwatch-agent/info/latest/RELEASE_NOTES 또는 https://s3.region.amazonaws.com/amazoncloudwatch-agent-Region/info/latest/RELEASE_NOTES

  • https://s3.amazonaws.com/amazoncloudwatch-agent/info/latest/CWAGENT_VERSION 또는 https://s3.region.amazonaws.com/amazoncloudwatch-agent-Region/info/latest/CWAGENT_VERSION

로그gCloudWatch 에 전원을 공급합니다.agent

에이전트는 실행 중에 로그를 생성합니다. 이 로그에는 문제 해결 정보가 들어 있습니다. 이 로그는 amazon-cloudwatch-agent.log 파일입니다. 이 파일은 Linux 서버의 /opt/aws/amazon-cloudwatch-agent/logs/amazon-cloudwatch-agent.log 및 Windows Server가 실행되는 서버의 $Env:ProgramData\Amazon\AmazonCloudWatchAgent\Logs\amazon-cloudwatch-agent.log에 있습니다.

amazon-cloudwatch-agent.log 파일에 추가 세부 정보를 기록하도록 에이전트를 구성할 수 있습니다. 에이전트 구성 파일에서agent섹션에서debug필드를true을 선택한 다음 CloudWatch 에이전트를 재구성하고 다시 시작합니다. 이 추가 정보 기록을 비활성화하려면 debug 필드를 false로 설정하고 에이전트를 다시 구성하고 다시 시작합니다. 자세한 정보는 직접 만들기c리테이트 또는eCloudWatch 사용a젠트c분류: 상상file을 참조하십시오.

중지 및rCloudWatch 시작agent

다음 중 하나를 사용하여 CloudWatch 에이전트를 수동으로 중지할 수 있습니다.AWS Systems Manager또는 명령줄을 선택합니다.

실행 명령을 사용하여 CloudWatch 에이전트를 중지하려면

  1. Systems Manager 콘솔을 엽니다.https://console.aws.amazon.com/systems-manager/.

  2. 탐색 창에서 Run Command를 선택합니다.

    -또는-

    만약AWS Systems Manager홈페이지가 열리면, 아래로 스크롤하고Expland 실행.

  3. Run 명령을 선택합니다.

  4. 명령 문서 목록에서 AmazonCloudWatch-ManageAgent를 선택합니다.

  5. 에서대상영역에서 CloudWatch 에이전트를 설치한 인스턴스를 선택합니다.

  6. 작업 목록에서 중지를 선택합니다.

  7. Optional Configuration Source(구성 소스(선택 사항))Optional Configuration Location(구성 위치(선택 사항))을 비워둡니다.

  8. 실행을 선택합니다.

명령줄을 사용하여 CloudWatch 에이전트를 로컬에서 중지하려면

  • Linux 서버의 경우 다음을 입력합니다.

    sudo /opt/aws/amazon-cloudwatch-agent/bin/amazon-cloudwatch-agent-ctl -m ec2 -a stop

    Windows Server가 실행되는 서버의 경우 관리자로서 PowerShell에 다음을 입력합니다.

    & $Env:ProgramFiles\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1 -m ec2 -a stop

에이전트를 다시 시작하려면 CloudWatch 시작agent 섹션의 지침을 따르십시오.