AWS IoT Core 모니터링

온라인에서 편집하기

Instana 를 사용하여 AWS IoT Core 를 모니터링하면 IoT 환경에 대한 종단 간 가시성을 확보할 수 있습니다. AWS IoT Core 를 모니터링하려면 환경에 Instana 에이전트를 설치하십시오. 에이전트는 AWS IoT Core 센서를 자동으로 배포하며, 이 센서는 IoT 메트릭을 수집합니다. 이 지표들은 Instana UI에서 확인할 수 있습니다.

참고: AWS IoT Core 는 기기를 AWS 클라우드에 연결해 주는 클라우드 서비스입니다. AWS 에서 지원하는 다른 서비스에 대해서는 ‘ AWS ’ 항목을 참조하십시오.

필수 IAM 권한

온라인에서 편집하기

AWS IoT Core 센서가 AWS IoT Core 를 모니터링하려면 다음 AWS IAM 권한이 필요합니다:

  • cloudwatch:GetMetricData
  • cloudwatch:GetMetricStatistics
  • iot:DescribeEndpoint
  • iot:ListThings

AWS IoT Core 센서 구성

온라인에서 편집하기

Instana 에이전트가 설치되면 AWS IoT Core 센서가 기본적으로 활성화됩니다. AWS IoT Core 의 메트릭은 60초마다 수집됩니다. <agent_install_dir>/etc/instana/configuration.yml 파일에서 이 설정을 변경할 수 있습니다.

com.instana.plugin.aws.iotcore:
  cloudwatch_period: 60

프록시 설정 활성화

온라인에서 편집하기

AWS IoT Core 센서가 프록시 구성을 사용할 수 있도록 하려면 다음 에이전트 구성 설정을 추가하십시오:

com.instana.plugin.aws.iotcore:
  proxy_host: 'example.com' # proxy host name or ip address
  proxy_port: 3128 # proxy port
  proxy_protocol: 'HTTP' # proxy protocol: HTTP or HTTPS
  proxy_username: 'username' # OPTIONAL: proxy username
  proxy_password: 'password' # OPTIONAL: proxy password

AWS IoT Core 센서 비활성화

온라인에서 편집하기

IoT Core 인스턴스의 모니터링을 사용 안함으로 설정하려면 다음 구성을 사용하십시오.

com.instana.plugin.aws.iotcore:
  enabled: false

여러 AWS 계정에 걸쳐 AWS IoT Core 모니터링 구성하기

온라인에서 편집하기

동일한 지역에서 하나의 AWS 에이전트를 사용하여 여러 AWS 계정의 모니터링을 설정하기 위해 두 가지 방법을 사용할 수 있습니다. 자세한 정보는 다중 AWS 계정 모니터링을 참조하십시오.

AWS -명명된 프로필 방식

온라인에서 편집하기

AWS IoT Core 모니터링에 사용할 프로필을 재정의하려면 다음 구성을 사용하십시오:

com.instana.plugin.aws.iotcore:
  profile_names:
    - 'profile2'
    - 'profile3'
참고: 서비스 수준에서 프로필을 정의하면, 전역 AWS 프로필 구성이 무시됩니다.

AWS STS 접근법

온라인에서 편집하기

IoT Core를 모니터하는 데 사용되는 IAM 역할을 대체하려면 다음 구성을 사용하십시오.

com.instana.plugin.aws.iotcore:
  role_arns:
    - 'arn:aws:iam::<account_1_id>:role/<role_1_name>'
    - 'arn:aws:iam::<account_2_id>:role/<role_2_name>'
참고: 서비스 수준에서 IAM 역할을 정의하면, 전역 AWS IAM 역할 구성이 무시됩니다.

태그를 지정하여 필터링하기

온라인에서 편집하기

IoT Core 브로커에 태그를 지정할 수 없으므로 태그를 정의하여 필터링하는 것은 지원되지 않습니다.

메트릭 보기

온라인에서 편집하기

메트릭을 보려면 다음 단계를 완료하십시오.

  1. Instana UI의 탐색 메뉴에서 ‘인프라’를 선택합니다.
  2. 모니터링 중인 특정 AWS IoT Core 인스턴스를 클릭하세요.

수집된 모든 지표가 표시된 AWS IoT Core 대시보드를 확인하실 수 있습니다.

구성 데이터

온라인에서 편집하기

AWS IoT Core 센서는 다음과 같은 IoT Core 데이터를 수집합니다:

  • 엔드포인트
  • 지역

메트릭

온라인에서 편집하기

다음 표에는 AWS IoT Core 센서가 수집하는 메트릭이 나열되어 있습니다:

이름 설명
연결 성공 메시지 브로커에 대한 성공적인 연결 수입니다.
연결 조절 계정이 허용되는 연결 요청 비율을 초과하여 조절된 연결 요청 수입니다.
연결 클라이언트 ID 조절 클라이언트가 특정 클라이언트 ID에 허용되는 연결 요청 비율을 초과하여 조절된 연결 요청 수입니다.
총 연결 조절 조절된 연결 요청의 총계입니다.
실행된 규칙 실행되는 AWS IoT 규칙의 수입니다.
ping 성공 메시지 브로커가 받은 Ping 메시지 수입니다.
연결 인증 오류 메시지 브로커가 권한을 부여할 수 없는 연결 요청 수입니다.
클라이언트 연결 오류 MQTT 메시지가 AWS IoT 할당량에 정의된 요구사항을 충족하지 않아 거부된 연결 요청 수입니다.
서버 연결 오류 내부 오류가 발생하여 실패한 연결 요청 수입니다.
공개 인증 오류 메시지 브로커가 권한을 부여할 수 없는 발행 요청 수입니다.
클라이언트에 공개 오류 메시지가 AWS IoT 할당량에 정의된 요구사항을 충족하지 않아 메시지 브로커가 거부한 게시 요청 수입니다.
서버에 공개 오류 내부 오류가 발생하여 메시지 브로커가 처리하는 데 실패한 발행 요청 수입니다.
공개 입력 성공 메시지 브로커가 성공적으로 처리한 발행 요청 수입니다.
공개 입력 조절 클라이언트가 허용되는 인바운드 메시지 비율을 초과하여 조절된 게시 요청 수입니다.
공개 출력 인증 오류 AWS IoT에서 권한을 부여할 수 없는 메시지 브로커가 작성한 게시 요청 수입니다.
Publish Out 클라이언트 오류 메시지가 AWS IoT 할당량에 정의된 요구사항을 충족하지 않아 거부된 메시지 브로커가 작성한 게시 요청 수입니다.
공개 출력 성공 메시지 브로커가 성공적으로 작성한 발행 요청 수입니다.
공개 출력 조절 클라이언트가 허용되는 아웃바운드 메시지 비율을 초과하여 조절된 게시 요청 수입니다.
가입 성공 메시지 브로커가 성공적으로 처리한 구독 요청 수입니다.
구독 조절 클라이언트가 허용되는 구독 요청 비율을 초과하여 제한된 구독 요청 수입니다.
수락된 사물 새도우 가져오기 성공적으로 처리된 GetThingShadow 요청의 수.
수락된 사물 새도우 업데이트 성공적으로 처리된 UpdateThingShadow 요청의 수.
수락된 사물 새도우 삭제 성공적으로 처리된 DeleteThingShadow 요청의 수.
수락된 사물 샤도우 나열 성공적으로 처리된 ListThingShadow 요청의 수.