소개
이 문서에서는 REST API를 사용하여 AppDynamics에서 사용자 지정 이벤트를 구성하고 이를 상태 규칙에 연결하여 자동화된 알림을 제공하는 방법에 대해 설명합니다.
사전 요구 사항
- AppDynamics SaaS 또는 온-프레미스 컨트롤러 인스턴스에 액세스
- 이벤트, 상태 규칙 및 정책을 만들고 관리할 수 있는 권한
- 컨트롤러 버전 21.x 이상
- 알림 채널(이메일, SMS 또는 서드파티 통합) 구성
- REST API 및 AppDynamics 사용자 인터페이스에 대한 기본 이해
요구 사항
시작하기 전에 다음 요구 사항을 충족해야 합니다.
- AppDynamics Controller 버전 21.x 이상(최신 이벤트 및 알림 기능)
- 컨트롤러에 대해 활성화된 REST API 액세스
- 알림 전달을 위해 구성된 알림 채널(이메일, sms 또는 통합)
사용되는 구성 요소
- AppDynamics 컨트롤러
- AppDynamics 에이전트
- 알림 채널
이 문서의 정보는 특정 랩 환경의 디바이스를 토대로 작성되었습니다. 이 문서에 사용된 모든 디바이스는 초기화된(기본) 컨피그레이션으로 시작되었습니다. 현재 네트워크가 작동 중인 경우 모든 명령의 잠재적인 영향을 미리 숙지하시기 바랍니다.
배경 정보
점점 더 동적인 클라우드 네이티브 아키텍처의 세계에서 사전 대응적 모니터링은 시스템 탄력성을 보장하고 MTTR(Mean Time to Resolution)을 줄이기 위해 필수적입니다. AppDynamics는 운영 팀이 이상 징후를 더 빨리 감지하고 정확하게 대응하는 데 도움이 되는 맞춤형 이벤트 및 알림을 생성하는 기능을 포함하여 강력한 관찰 기능을 제공합니다.
즉시 사용 가능한 메트릭은 매우 중요하지만, 현대의 시스템에는 상황별 관찰이 필요한 경우가 많습니다. CI/CD 파이프라인, 사용자 지정 자동화 도구 또는 외부 시스템을 통합하는 경우 AppDynamics에 사용자 지정 이벤트를 삽입하면 다음을 보장할 수 있습니다.
- 시스템 및 비즈니스 메트릭 전반에 걸친 통합 가시성
- 애플리케이션별 이상 징후 실시간 탐지
- 자동화된 작업을 통해 수동 작업 감소
때로는 사용자 지정 이벤트를 만들어 애플리케이션의 특정 측면을 모니터링하는 것이 좋습니다. 이 문서에서는 AppDynamics 컨트롤러에서 REST API를 통해 사용자 지정 이벤트를 만드는 방법과 사용자 지정 이벤트를 기반으로 알림을 설정하는 방법을 안내합니다.
구성
이 섹션에서는 AppDynamics Controller에서 사용자 지정 이벤트를 생성하고 알림을 구성하는 단계별 프로세스에 대해 설명합니다.
설정
1단계: REST API를 통해 맞춤형 이벤트 생성
AppDynamics REST API를 사용하여 사용자 지정 이벤트를 생성할 수 있습니다. 이는 외부 시스템, 사용자 정의 스크립트, 자동화 프레임워크 또는 타사 툴을 통합하는 데 유용합니다.
API 호출 예:
POST https:///controller/rest/applications//events?severity=ERROR&summary=Application+Stopped&eventtype=CUSTOM&customeventtype=App_Stop&comment=Please_start_application
주요 매개변수:
- <controller-url> 및 <application_id>를 컨트롤러 세부 정보로 교체합니다.
- 필수 매개 변수:
- 심각도(INFO, WARN, ERROR)
- 요약(짧은 설명)
- eventtype(CUSTOM이어야 함)
- customeventtype(사용자 지정 이벤트 유형 레이블)
- 코멘트(선택적 세부 메시지)
요청이 성공하면 생성을 확인하는 이벤트 ID가 반환됩니다
예: "이벤트 ID를 만들었습니다.550346816"
가시성 팁: 삽입된 이벤트를 보려면 Events UI에서 Custom(맞춤형) 필터를 활성화해야 합니다.

2단계: 맞춤형 이벤트 필터링 및 모니터링
- Controller UI에서 Events(이벤트) 섹션으로 이동합니다.
- 이벤트 유형 또는 속성을 추가하려면 Filter by Custom Events를 사용합니다.
- 더 세분화된 필터링을 위해 키/값 쌍을 지정할 수 있습니다.
- AND 논리에 All(모든 속성이 일치해야 함) 또는 OR 논리에 Any(하나 이상의 속성 일치) 사용
이렇게 하면 응용 프로그램 전체에서 삽입된 이벤트를 표적 추적 및 조사할 수 있습니다.
3단계: 경고 구성: 작업 및 정책
작업:
- 사용자 지정 이벤트가 트리거될 때 수행되는 작업(예: 이메일 보내기, sms 또는 웹후크 호출)을 지정합니다.

정책:
- 새 정책을 생성하거나 기존 정책을 수정합니다.

- 정책에서 정의한 사용자 지정 이벤트와 일치하도록 사용자 지정 이벤트 필터를 구성합니다.


- Policy Actions(정책 작업) 탭에서 새 작업을 추가하고 생성한 사용자 지정 작업을 선택합니다.

- 경고를 저장합니다. 경고를 구성한 후 Save(저장)를 클릭하여 경고를 생성합니다.

알림을 생성하면 지정된 기준과 일치하는 사용자 지정 이벤트가 컨트롤러에서 생성될 때마다 트리거됩니다.
다음을 확인합니다.
- REST API를 통해 테스트 사용자 지정 이벤트를 게시합니다.

- Events UI에서 가시성 확인(필터 선택):

- 사용자 지정 이벤트에 대해 작업이 트리거되었는지 확인합니다.



문제 해결
문제 |
문제 해결 단계 |
이벤트가 표시되지 않음
|
- 이벤트 UI에서 사용자 지정 필터가 이벤트 유형인지 확인합니다.
- API 호출에서 eventtype 및 customeventtype 매개 변수를 다시 확인합니다.
|
API 오류
|
- 일반 오류: "이벤트 요약이 지정되지 않았습니다." 항상 요청에 대한 요약 정보 제공
- API 호출에서 인증 및 애플리케이션 ID를 확인합니다.
|
경고가 트리거되지 않음
|
- 상태 규칙 및 정책이 올바르게 구성되었는지 확인합니다.
- 알림 채널 설정(이메일/sms 서버 컨피그레이션)을 확인합니다.
|
사용자 지정 이벤트 제한
|
- 컨트롤러에는 사용자 지정 이벤트 스키마 수 및 이벤트 크기에 대한 제한이 있습니다.
- 대용량 또는 복잡한 스키마를 게시할 경우 문서 검토
|
결론
AppDynamics의 사용자 지정 이벤트 및 알림은 관찰 가능성 전략을 강화할 수 있는 강력한 방법을 제공합니다. CI/CD 도구, 외부 서비스 또는 주요 워크플로에 대한 가시성을 확장하든 관계없이 이러한 기능을 통해 사용자에게 영향을 미치기 전에 문제를 더 빠르게 탐지하고 해결할 수 있습니다. 사용자 지정 관찰 인텔리전스를 활용하여 모니터링을 사후 대응에서 예측으로 승격시키십시오.
추가 지원 필요
질문이 있거나 문제가 있는 경우 AppDynamics 지원에 문의하고 오류 메시지, 구성 정보 또는 관련 로그와 같은 세부 정보를 포함하여 신속한 문제 해결을 도와주십시오.
관련 정보