APM Command Center를 사용하여 에이전트 구축 및 관리

에이전트 패키지, 번들, 컬렉션 및 CA Marketplace 확장을 사용한 작업 방법을 알아보십시오.
apmdevops104kr
에이전트 패키지, 번들, 컬렉션 및 CA Marketplace 확장을 사용한 작업 방법을 알아보십시오.
CA ACC(APM Command Center)를 통해 다음을 수행할 수 있습니다.
  • 에이전트 컬렉션 생성
  • 번들 가져오기
  • 패키지 생성
패키지는 에이전트 구성을 나타냅니다. 대상 응용 프로그램 환경에 맞게 새 패키지를 생성하고 특정 요구 사항에 따라 패키지를 구성하십시오.
에이전트를 설치하려면 아카이브 파일 형식으로 패키지를 다운로드하십시오. 설치 후에는 에이전트가 패키지 정보를 보고합니다. 패키지의 세부 사항을 동적으로 편집하고 UI에서 새 패키지 버전을 에이전트에 적용할 수 있습니다.
에이전트 컬렉션을 사용하여 한 번에 여러 에이전트에 새 패키지 버전을 적용할 수 있습니다. 패키지는 에이전트 기능의 하위 집합을 나타내는 번들의 조합으로 구성됩니다. 각 번들에 대해 종속성, 상호 관계 및 호환성 요구 사항이 정의되며 이에 따라 가능한 조합이 결정됩니다.
참고
: ACC API를 사용하여 패키지 및 번들을 관리하고 프로세스의 일부를 자동화할 수 있습니다. 자세한 내용은 CA APM Command Center API를 참조하십시오.
에이전트 패키지
에이전트 패키지는 ZIP 또는 TAR 형식의 배포 가능한 에이전트 바이너리 및 구성 파일 모음입니다.
패키지를 생성하려면 다음 단계를 수행하십시오.
  1. "Agent Builder"(에이전트 작성기) 마법사를 사용합니다.
  2. 환경을 정의하고 기본 설치 지침을 사용자 지정합니다.
  3. 패키지를 다운로드하여 배포합니다. 
    참고:
    번들을 추가 또는 제거하고 구성 속성을 수정하여 패키지를 세부적으로 사용자 지정할 수도 있습니다.
패키지를 배포하고 에이전트를 응용 프로그램 서버와 함께 시작되도록 구성한 후에는 UI에서 직접 어떤 에이전트가 어떤 패키지를 사용하는지 확인합니다.
추가 정보:
다음 비디오에서는 ACC에서 에이전트 패키지를 생성하는 방법을 보여 줍니다.

패키지 버전
배포된 패키지에는 추적을 위한 버전 번호가 있습니다. 패키지의 버전 번호는 1입니다. 패키지 편집 시 사용자가 패키지를 다운로드할 때까지는 버전 번호가 1로 유지됩니다. 다운로드 후에는 버전 번호가 2가 됩니다.
버전 번호는 UI에 표시되며 사용자는 버전 번호를 사용하여 다음을 수행할 수 있습니다. 
  • 패키지의 특정 버전 보기
  • 특정 버전의 패키지 다운로드
  • 새 패키지에 특정 패키지 버전 복사
패키지 버전을 아카이브할 수 있습니다. 아카이브된 패키지 버전은 다운로드할 수 없으며 다른 어떤 작업에도 사용할 수 없으므로 실수로 이 패키지를 사용하게 되는 경우는 없습니다. 새로 생성되는 패키지 버전은 현재 버전(아카이브 버전이 아닌 최신 버전)을 기반으로 합니다.
패키지 업그레이드
패키지를 업그레이드하려면 에이전트 버전을 변경하십시오.
다음 단계를 따르십시오.
  1. UI에서 "Packages"(패키지) 페이지로 이동한 후 패키지를 선택하고
    Edit
    (편집)를 클릭합니다.
  2. "Agent"(에이전트) 카드의 드롭다운 목록에서 업그레이드하려는 대상 버전을 선택합니다.
이전에 패키지에서 변경한 모든 구성은 그대로 유지됩니다. CA Technologies에서 추가한 새 속성이나 변경된 속성은 자동으로 포함됩니다.
참고:
번들의 설치 지침을 변경한 다음 이 번들의 설치 지침이 없는 패키지 버전으로 업그레이드하면 변경 사항이 업그레이드된 패키지에 반영되지 않습니다.
다운로드 후 패키지를 적용할 수 있습니다.
번들
완성된 에이전트 패키지는 여러 개의 번들로 구성됩니다. 번들은 에이전트 기능의 일부분을 나타냅니다. 예를 들어 SQL, SOAP 웹 서비스, HTTP 백엔드, 서블릿, JSP 등을 위한 번들이 있습니다. 
패키지를 사용자 지정하려면 다음을 수행하면 됩니다.
  • 번들을 추가하거나 제거합니다.
  • 번들 구성을 변경합니다.
  • 기본 설치 지침을 편집합니다.
패키지를 사용자 지정할 때 마법사를 사용하여 패키지의 번들을 추가하거나 제거할 수 있습니다.
다음 두 개의 열에 사용 가능한 번들과 선택된 번들이 나열됩니다.
  • Available Bundles
    (사용 가능한 번들) - 선택한 환경과 호환되는 특수 모니터링을 위한 선택적 번들입니다. 예를 들어 'Leak Hunter' 번들이 이에 해당합니다.
  • Selected Bundles
    (선택된 번들) - 선택한 환경에서 모니터링하는 데 필요하거나 권장되는 미리 선택된 기본 번들입니다. 예를 들어 Tomcat을 모니터링하기 위해 'Struts' 번들이 필요하거나, Tomcat에 'SOA' 번들이 권장됩니다.
두 열에 나열되는 번들은 다음과 같은 번들 유형에 따라 그룹화되어 있습니다.
  • Core(핵심)
    Java 에이전트 바이너리나 ACC 확장과 같은 핵심 모니터링 구성 요소입니다.
  • 환경
    환경 그룹에는 플랫폼에 따라 응용 프로그램 서버를 모니터링하는 번들이 포함됩니다.
  • Features
    메트릭 가시성을 개선하는 다양한 APM 모니터링 기능입니다.
  • 사용자 지정
    비공식적인 확장입니다. 자세한 내용은 사용자 지정 번들 추가을 참조하십시오.
번들을 선택하면 해당 기능에 대한 정보가 표시됩니다. 선택한 번들에 다른 번들이 필요한 경우에는 해당 번들이 강조 표시됩니다.
설치에 포함된 전체 번들 목록은 번들 목록을 참조하십시오.
번들 구성
마법사의 "Configure Bundles"(번들 구성) 페이지에서 포함된 각 번들과 관련된 IntroscopeAgent.profile의 섹션을 볼 수 있습니다. 현재 속성을 편집하거나 새 속성을 추가할 수 있습니다. 변경 이유를 설명하는 주석을 추가하십시오.
참고:
이전에 추가한 속성은 삭제할 수만 있습니다.
번들 설치 지침
해당하는 경우 각 번들은 해당 번들에 대한 설치 지침과 함께 제공됩니다. 패키지에 대한 설치 지침은 패키지에 포함된 개별 번들의 설치 지침이 모두 조합된 것입니다.
사용 환경에 맞게 지침을 사용자 지정하려면 지침을 편집하십시오. 텍스트 형식을 지정하는 데는 마크다운 언어 구문을 사용하십시오. 변경 내용은 편집하는 패키지에만 적용되고 다른 패키지에는 전파되지 않습니다.
추가 정보:
이 비디오에서 에이전트 패키지의 내용과 속성을 사용자 지정하는 방법을 알아보십시오.

CA APM Command Center로 번들 가져오기
사용자 고유의 사용자 지정 번들을 생성하거나, CA Marketplace에서 APM 확장을 다운로드할 수 있습니다.
두 경우 모두 가져오기 절차는 동일합니다.
다음 단계를 따르십시오.
  1. "Bundles"(번들) 페이지로 이동하여
    Import
    (가져오기) 단추를 클릭합니다.
  2. 생성하거나 다운로드한 번들을 찾아
    Open
    (열기)을 클릭합니다.
  3. "Packages"(패키지) 페이지에서 해당 번들을 원하는 패키지에 추가합니다.
Collections
컬렉션은 이름과 개체 유형을 갖는 저장된 검색 문자열입니다. 에이전트, 진단 보고서, 번들 및 패키지에는 컬렉션을 적용할 수 있습니다.
컬렉션을 생성하려면 검색 상자에 검색 용어를 입력하고
Save as new Collection
(새 컬렉션으로 저장)을 선택합니다. 필요한 경우 이름을 변경하고 검색 용어를 편집할 수 있습니다.
컬렉션에 패키지 푸시
에이전트와 패키지 버전의 호환성을 위해서는 다음과 같은 사전 요구 사항이 충족되어야 합니다.
  • 유효한 ACC가 패키지를 생성했습니다. 패키지는 동일한 ACC 서버에 의해 생성되어야 합니다.
  • 하나 이상의 에이전트 컬렉션이 표시됩니다.
  • 에이전트는 주 버전이 동일한 에이전트를 실행해야 합니다.
  • 에이전트는 동일한 응용 프로그램 서버에서 실행해야 합니다.
  • 에이전트는 동일한 OS(Unix 또는 Windows)에서 실행해야 합니다.
다음 절차에는 에이전트 컬렉션에 패키지를 푸시하는 단계가 나와 있습니다.
다음 단계를 따르십시오.
  1. Packages
    (패키지) 화면에서 컬렉션에 적용할 패키지를 선택합니다. 현재 패키지가 에이전트에서 실행되는 다른 패키지와 호환되는지 확인하려면 패키지 버전
    APPLY
    (적용) 단추를 사용하도록 설정하십시오.
  2. 패키지 버전의 호환되는 컬렉션 목록을 표시하려면
    APPLY
    (적용)를 클릭합니다.
    참고:
    한 번에 하나의 컬렉션에만 패키지 버전을 적용할 수 있습니다. 여러 컬렉션에 적용하려면 기존 컬렉션을 병합하는 새 컬렉션을 만듭니다.
  3. +를 클릭하여 컬렉션의 호환 가능한 에이전트 목록을 표시합니다.
    참고
    : 시스템에는 모든 호환성 사전 요구 사항을 충족하는 에이전트만 표시됩니다.
  4. 작업을 시작하려면
    APPLY
    (적용)를 클릭합니다.
    작업이 완료되었습니다. 잠재적인 오류는 패키지 카드의 아랫부분을 참조하십시오.
  5. 작업이 완료되면 올바른 수의 에이전트가 새 버전의 패키지를 실행하고 있는지 확인합니다. UI를 새로 고쳐야 할 수 있습니다.