Discover

Get Started

Developers

Industries

Integrate Cisco AppDynamics Monitoring

개요

파일 전송 작업과 기기 상태 변화를 Cisco AppDynamics로 전송하여 모니터링하려면 AppDynamics 연동을 설정할 수 있습니다.

이 연동은 AppDynamics의 Analytics Events API를 사용하여 이벤트를 커스텀 이벤트로 전송하는 방식입니다.

연동을 완료하면 전송이 시작(Transfer Started), 완료(Transfer Completed) 되거나 기기가 연결(Device Connected), 해제(Device Disconnected) 되는 등 지정한 이벤트가 발생할 때마다 AppDynamics로 이벤트가 전송되어 Analytics에서 모니터링할 수 있습니다.

전체 과정은 ① 자격 증명 확인 및 스키마 준비 → ② 제품에서 연동 설정 두 단계로 진행됩니다.

준비 사항

시작하기 전에 다음 사항을 확인하세요.

항목설명
AppDynamics 계정Events API Key를 발급하고 Global Account Name을 확인할 수 있는 AppDynamics(Controller) 계정이 필요합니다.
이벤트 스키마이벤트를 저장할 커스텀 이벤트 스키마(이벤트 유형)가 미리 정의되어 있어야 합니다.
라이선스커스텀 이벤트 게시에는 Transaction Analytics 라이선스가 필요합니다.
네트워크제품이 설치된 환경에서 Events Service 엔드포인트로의 외부 HTTPS 통신이 허용되어야 합니다. (SaaS는 443, 온프레미스는 기본 포트 9080)

자격 증명 확인 및 스키마 준비

AppDynamics로 이벤트를 전송하려면 Events Service Endpoint, Global Account Name, Events API Key가 필요하며, 이벤트를 저장할 커스텀 이벤트 스키마(Event Schema) 도 준비해야 합니다.

Step 1. Events Service Endpoint 확인

이벤트를 전송할 Events Service Endpoint를 확인합니다.

SaaS 환경에서는 SaaS Domains and IP Ranges 페이지에서 Analytics(Events Service) 도메인을 확인합니다. (예: https://analytics.api.appdynamics.com)

온프레미스 환경에서는 Events Service 호스트와 기본 포트 9080을 사용합니다.

2_1

Step 2. Global Account Name 확인

Controller UI의 Settings → License → Accounts에서 Global Account Name을 확인합니다.

2_2

Step 3. Events API Key 발급

Controller의 Analytics → Configuration → API Keys → Add에서 API Key를 생성합니다.

API Key에는 Manage and Publish Custom Analytics Events 권한이 있어야 합니다.

생성된 API Key를 복사합니다.

API Key는 비밀번호와 같으므로 공개 저장소나 외부 문서에 노출되지 않도록 주의합니다.

이벤트 전송은 반드시 HTTPS를 사용해야 하며, 유출된 경우 기존 키를 삭제하고 새로 발급합니다.

2_3

Step 4. 이벤트 스키마 준비

이벤트를 저장할 커스텀 이벤트 스키마(Event Schema)를 준비하고 스키마 이름을 확인합니다.

스키마 이름은 이벤트 게시 경로에 사용되며, 스키마가 존재하지 않으면 이벤트 게시가 실패합니다.

2_4

확인 사항

✔ Events Service Endpoint를 확인했습니다.

✔ Global Account Name을 확인했습니다.

✔ Events API Key를 발급했습니다.

✔ 대상 이벤트 스키마를 준비했습니다.

Cisco AppDynamics 연동 설정

확인한 값을 제품의 설정에 입력합니다.

Monitoring 설정 창을 열면 아래와 같은 화면이 표시됩니다.

2_5

Step 1. Events Service Endpoint 입력

Events Service Endpoint 항목에 확인한 주소를 입력합니다.

(예: https://analytics.api.appdynamics.com)

Step 2. Global Account Name 입력

Global Account Name 항목에 확인한 값을 입력합니다.

Step 3. Events API Key 입력

Events API Key 항목에 발급한 키를 입력합니다.

Step 4. Event Schema Name 입력

Event Schema Name 항목에 이벤트를 저장할 커스텀 이벤트 스키마 이름을 입력합니다.

Step 5. 이벤트 선택

Events 항목에서 모니터링할 이벤트를 선택합니다.

여러 개를 선택할 수 있으며, 선택한 이벤트가 발생할 때만 AppDynamics로 전송됩니다.

이벤트발생 시점
Transfer Started전송 작업이 시작되었을 때
Transfer Completed전송이 정상적으로 완료되었을 때
Transfer Paused전송이 일시 중지되었을 때
Transfer Recovered중단 또는 오류 후 전송이 자동 복구되어 재개되었을 때
Device Connected기기가 연결되었을 때
Device Disconnected기기 연결이 해제되었을 때

Step 6. 설정 저장

입력을 마쳤으면 Add를 클릭하여 연동을 저장합니다.

확인 사항

✔ Events Service Endpoint가 입력되었습니다.

✔ Global Account Name이 입력되었습니다.

✔ Events API Key가 입력되었습니다.

✔ Event Schema Name이 입력되었습니다.

✔ 모니터링할 이벤트가 선택되었습니다.

연동 확인

설정이 정상적으로 동작하는지 확인합니다.

Step 1. 테스트 이벤트 발생

실제 전송 작업을 실행하거나 선택한 이벤트를 발생시킵니다.

2_6

Step 2. AppDynamics 확인

AppDynamics Analytics에서 해당 Event Schema의 이벤트가 수집되었는지 확인합니다.

2_7

확인 사항

✔ AppDynamics에 이벤트가 수집되었습니다.

✔ 발생한 이벤트가 정상적으로 전달되었습니다.

설정 완료

설정을 저장하면 연동이 적용됩니다.

이후 선택한 이벤트가 발생할 때마다 AppDynamics로 이벤트가 자동으로 전송됩니다.

문제 해결 (Troubleshooting)

문제확인 사항
이벤트가 표시되지 않음Events Service Endpoint, Global Account Name, Events API Key, Event Schema Name이 정확한지, 앞뒤 공백이나 누락이 없는지 확인
인증 오류가 발생함Events API Key와 Global Account Name이 올바른지 확인
게시 권한 오류가 발생함API Key에 Manage and Publish Custom Analytics Events 권한이 있는지, Transaction Analytics 라이선스가 활성화되어 있는지 확인
스키마 오류가 발생함대상 Event Schema가 미리 생성되어 있는지, 전송 데이터의 필드가 스키마와 일치하는지 확인
폐쇄망에서 연동 실패Events Service 엔드포인트(SaaS 443 / 온프레미스 9080)로의 아웃바운드 통신이 방화벽 또는 프록시에서 허용되는지 확인