CloudWatch 치에서의 오픈텔레메트리 지원agent - Amazon CloudWatch

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

CloudWatch 치에서의 오픈텔레메트리 지원agent

버전 1.247347.3 및 이후 버전의 CloudWatch 에이전트에는AWSOpenTelemetry 수집기 이를 통해 CloudWatch 에이전트는AWS그리고 EC2 인스턴스의 애플리케이션 원격 분석 데이터를 CloudWatch 및AWS X-Ray. 이 기능은 여러 에이전트를 설치하거나 구성하지 않고 OpenTelemetry를 사용하여 모니터링을 시작하려는 기존 CloudWatch 에이전트 사용자를 위한 것입니다. 에 대한 자세한 내용AWSOpenTelemetry (참조)AWS오픈텔레메트리를 위한 배포판.

CloudWatch 에이전트를 사용하여AWSOpenTelemetry 수집기를 사용하는 경우 별도의AWSOpenTelemetry 수집기

내장된 OpenTelemetry 수집기가 있는 CloudWatch 에이전트는AWS오픈텔레메트리 SDK를 통해 CloudWatch X-Ray 에 게시할 수 있습니다. CloudWatch 에이전트에 포함된 오픈텔레메트리 수집기는AWSOpenTelemetry 수집기를 사용하면 별도의AWSOpenTelemetry 수집기 그러나 동일한 서버에 둘 다 설치하는 경우 CloudWatch 에이전트에 포함된 OpenTelemetry 수집기와AWSOpenTelemetry 수집기는 서로 다른 디렉터리에 있으며 다양한 도구를 통해 관리되며 별도의 프로세스로 실행됩니다. 예를 들어 동일한 서버에서 두 프로세스를 모두 구성하고 실행하는 경우 수신 대기하는 데 사용하는 로컬 포트가 서로 충돌하지 않도록 해야 합니다.

CloudWatch 에이전트의 OpenTelemetry는 EC2 인스턴스에서 실행되는 CloudWatch 에이전트에 대해 지원되지만 컨테이너 또는 온프레미스 서버에서 실행되는 CloudWatch 에이전트에는 지원되지 않습니다. x86-64 아키텍처와 ARM64 아키텍처는 모두 Linux 인스턴스에서 지원되며 x86-64는 Windows 서버 인스턴스에서 지원됩니다.

IAM 권한

OpenTelemetry 지표 및 추적을 게시할 수 있으려면 CloudWatch 에이전트에 추가 IAM 권한이 필요합니다.CloudWatchAgentServerPolicy관리형 정책. 에이전트의 OpenTelemetry 지원을 사용하려는 서버에서 인스턴스에 연결된 CloudWatch 에이전트의 IAM 역할에 다음 정책을 부여합니다. 설명서에서 기본 제안 이름을 사용한 경우이 역할은CloudWatchAgentServerRole.

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "xray:PutTraceSegments", "xray:PutTelemetryRecords", "xray:GetSamplingRules", "xray:GetSamplingTargets", "xray:GetSamplingStatisticSummaries", "ssm:GetParameters" ], "Resource": "*" } ] }

CloudWatch 에이전트 OpenTelemetry 구성

Amazon은 내장된 OpenTelemetry 수집기에 대한 기본 구성 파일을 제공합니다. 이 구성을 사용하면 기본 포트를 통해 OpenTelemetry 메트릭 및 추적을 수집할 수 있습니다. 기본 구성이 제대로 작동하는 경우 구성 단계를 수행할 필요가 없습니다. 이 기본 구성 파일의 내용을 보려면설정.yamlGithub의.

구성 파일을 사용자 지정하려면 AWS오픈텔레메트리를 위한 배포판. 이렇게 하면 사용자 정의 구성 파일을 만든 후 매개변수 저장소에 업로드하거나 사용할 모든 서버의 파일 시스템에 복사할 수 있습니다. 매개변수 저장소에 업로드하는 방법에 대한 자세한 내용은 단원을 참조하세요. CloudWatch 지표 업로드a젠트c분류: 상상fSystems Manager 파라미터 스토어.

명령줄을 사용하여 OpenTelemetry 지원을 통해 CloudWatch 에이전트 관리

OpenTelemetry 지원이 내장된 CloudWatch 에이전트는 CloudWatch 에이전트 프로세스와 오픈텔레메트리 수집기 프로세스의 두 프로세스로 실행됩니다. CloudWatch 에이전트를 시작할 때 각 프로세스는 성공적으로 시작할 수 있는지 여부를 별도로 결정합니다.

다음을 실행할 수 있습니다.amazon-cloudwatch-agent-ctl스크립트를 사용하여 OpenTelemetry 수집기 프로세스를 관리했습니다. 포함된 OpenTelemetry 수집기를 구성하고 시작하려면 다음 명령 중 하나를 실행합니다.

Linux:

sudo /usr/bin/amazon-cloudwatch-agent-ctl -a fetch-config -o configuration-file -s

Windows Server:

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a fetch-config -o configuration-file -s

이 명령에서-a fetch-config가 OpenTelemetry 수집기에 대한 구성을 로드합니다. 구성은 기본 구성이거나 매개변수 저장소 또는 로컬 파일의 사용자 구성일 수 있습니다. 이-s매개 변수는 이 구성으로 에이전트를 다시 시작합니다.

의 값구성 파일될 수 있습니다default을 클릭하여 기본 내장 구성을 사용합니다. 매개 변수 저장소에서 사용자 지정 구성을 사용하려면ssm:your-configuration-parameter-name. 구성을 로컬 파일에 저장하는 경우file:your-configuration-file.yaml.

예를 들어, 다음은 OpenTelemetry 수집기에 대한 기본 제공 구성으로 에이전트의 OpenTelemetry 프로세스를 구성하고 시작합니다.

sudo /usr/bin/amazon-cloudwatch-agent-ctl -a fetch-config -o default -s
중요

사용-o옵션을 사용하여 에이전트의 OpenTelemetry 수집기 프로세스를 구성하고-c옵션을 사용하면 CloudWatch 에이전트 프로세스를 구성할 수 있습니다. 다음 명령은 Linux에서 내장된 OpenTelemetry 수집기와 CloudWatch 에이전트를 각각 기본 제공 구성으로 시작하는 예제입니다.

sudo /usr/bin/amazon-cloudwatch-agent-ctl -a fetch-config -o default -c default -s

명령줄을 사용하여 CloudWatch 에이전트에서 OpenTelemetry 수집기를 중지하고 시작합니다.

OpenTelemetry 수집기 프로세스만 중지

에이전트에서 OpenTelemetry 프로세스를 중지하지만 CloudWatch 에이전트 프로세스가 계속 실행되도록 하려면 명령을 사용하여 에이전트에 OpenTelemetry 구성을 제거하도록 지시한 다음 OpenTelemetry 수집기에 대한 구성 없이 에이전트를 다시 시작합니다.

다음 명령에서-a remove-config -o는 CloudWatch 에이전트에 OpenTelemetry 수집기에 대한 구성 파일을 제거하도록 지시하고-s는 구성을 사용하지 않고 OpenTelemetry 수집기를 다시 시작하여 효과적으로 중지합니다.

Linux:

sudo /usr/bin/amazon-cloudwatch-agent-ctl -a remove-config -o configuration-file -s

Windows Server:

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a remove-config -o configuration-file -s

이 명령에서구성 파일를 지정할 수 있습니다.all를 사용하여 현재 적용된 구성을 제거합니다. 예를 들어 다음 명령은 구성을 제거하고 Linux에서 포함된 OpenTelemtry 수집기를 중지합니다.

sudo /usr/bin/amazon-cloudwatch-agent-ctl -a remove-config -o all -s

두 에이전트 프로세스 모두 중지

-a stop매개 변수를 사용하여 포함된 OpenTelemetry 수집기 프로세스와 CloudWatch 에이전트 프로세스가 실행 중인 경우 모두 중지할 수 있습니다.

Linux:

sudo /usr/bin/amazon-cloudwatch-agent-ctl -a stop

Windows Server:

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a stop

두 에이전트 프로세스 시작

-a start매개 변수를 사용하여 포함된 OpenTelemetry 수집기 프로세스와 CloudWatch 에이전트 프로세스가 이미 구성되어 있는 경우 모두 시작할 수 있습니다. OpenTelemetry 수집기를 구성한 적이 없는 경우 이 매개 변수를 사용해도 시작되지 않습니다. 이전에 CloudWatch 에이전트 프로세스를 시작한 적이 없는 경우 이 명령은 기본 구성으로 시작합니다.

Linux:

sudo /usr/bin/amazon-cloudwatch-agent-ctl -a start

Windows Server:

& "C:\Program Files\Amazon\AmazonCloudWatchAgent\amazon-cloudwatch-agent-ctl.ps1" -a start

Systems Manager 사용하여 내장된 OpenTelemetry 수집기로 CloudWatch 에이전트 관리

Systems Manager 사용하여 OpenTelemetry 수집기로 CloudWatch 에이전트를 관리할 수도 있습니다.

명령을 사용하여 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. 에서선택적 OpenTelemetry 구성 소스[] 목록에서 []SSM을 선택하거나 사용자 지정 구성을 사용하려는 경우기본값을 클릭하여 기본 구성을 사용합니다.

  8. 에서선택적 OpenTelemetry 구성 위치상자에 이전 단원에 설명된 대로 생성하고 Systems Manager 매개 변수 저장소에 저장한 OpenTelemetry 구성 매개 변수의 이름을 입력합니다.

  9. (선택 사항) CloudWatch 에이전트 프로세스를 동시에 구성하고 시작하려면 다음을 수행합니다.

    1. 에서선택적 구성 소스[] 목록에서 []SSM을 선택하거나 사용자 지정 구성을 사용하려는 경우기본값을 클릭하여 기본 구성을 사용합니다.

    2. 에서선택적 구성 위치상자에 Systems Manager 파라미터 저장소에 생성하고 저장한 CloudWatch 에이전트 구성 파라미터의 이름을 입력합니다.

  10. Optional Restart(재시작(선택 사항)) 목록에서 를 선택하여 해당 단계를 마친 후 에이전트가 시작되도록 합니다.

  11. 실행을 선택합니다.

  12. 필요에 따라타겟 및 출력영역에서 인스턴스 이름 옆에 있는 버튼을 선택하고출력 보기. Systems Manager 에이전트가 성공적으로 시작되었음을 표시해야 합니다.

구성을 제거하고 OpenTelemetry 수집기 프로세스를 중지하려면

  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. 에서선택적 OpenTelemetry 구성 소스[] 목록에서 []all.

  8. Optional Restart(재시작(선택 사항)) 목록에서 를 선택하여 해당 단계를 마친 후 에이전트가 시작되도록 합니다.

  9. 실행을 선택합니다.

  10. 필요에 따라타겟 및 출력영역에서 인스턴스 이름 옆에 있는 버튼을 선택하고출력 보기. Systems Manager 에이전트가 성공적으로 시작되었음을 표시해야 합니다.

OpenTelemetry 메트릭 및 추적 생성

AWS는 응용 프로그램이 OpenTelemetry 메트릭 및 추적을 생성하고 이를 OpenTelemetry 수집기에 공급하는 데 사용할 수 있도록 OpenTelemetry SDK와 Java 자동 계측 에이전트를 제공합니다. 자세한 내용은 다음 자료를 참조하십시오.