Servosity/prtg

PRTG Network Monitor Claude Code Skill

사전 요구 사항: CLI 설치

이 스킬은 prtg-cli 바이너리를 사용합니다. 이 스킬의 명령어를 호출하기 전에 반드시 CLI가 설치되어 있는지 확인해야 합니다. 설치되어 있지 않다면 먼저 설치하세요:

1. macOS / Linux:

   bash <(curl -fsSL https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/prtg/install.sh)
   

2. Windows (PowerShell):

   iwr -useb https://raw.githubusercontent.com/Servosity/msp-skills/main/skills/prtg/install.ps1 | iex
   

3. 확인: prtg-cli --version
4. ~/.local/bin (macOS / Linux) 또는 %LOCALAPPDATA%\Programs\msp-skills (Windows)가 $PATH에 있는지 확인하세요.

설치 프로그램은 prtg-cli 및 prtg-mcp 바이너리를 ~/.local/bin (macOS / Linux) 또는 %LOCALAPPDATA%\Programs\msp-skills (Windows)에 다운로드합니다. 에이전트에 스킬을 등록하지 않으며 MCP 클라이언트 구성을 작성하지 않습니다. 연결 설정은 mcp-install.md를 참조하세요.

설치 후 --version에서 "command not found"가 보고되면 런타임이 $PATH에서 바이너리 디렉토리를 찾을 수 없는 것입니다. 확인에 성공할 때까지 스킬 명령어를 진행하지 마세요.

각 클라이언트의 PRTG 코어를 core add로 한 번 등록한 후 fleet alarms, fleet status, fleet handoff 또는 fleet drift를 실행하여 모든 코어를 한 번에 확인하고, fleet ack, fleet pause, fleet resume을 실행하여 미리보기를 먼저 표시한 후 작업을 수행할 수 있습니다. 모든 v2 작업은 타입이 지정된 명령어로, --core로 특정 코어를 지정할 수 있습니다.

이 CLI를 사용하는 경우

이 CLI는 에이전트가 PRTG 모니터링 데이터나 작업이 필요할 때, 특히 core add로 등록된 여러 PRTG 코어(MSP 클라이언트당 하나)에 대해 사용합니다: 현재 알람, 교대 인계, 유지보수 일시 중지, 승인 및 에스테이트 위생을 확인할 수 있습니다. 또한 단일 코어에 대한 모든 PRTG API v2 작업을 노출합니다. 플릿 명령은 일부 코어가 실패해도 종료 코드 0을 반환하며(실패한 행에는 오류가 표시됨), 모든 코어가 실패하거나 전송된 작업이 실패한 경우에만 0이 아닌 코드를 반환합니다. 각 행의 error, action 및 failed 필드를 읽으세요. ack, pause, resume은 --yes가 추가될 때까지 미리보기만 표시합니다.

안티 트리거

다음 상황에서는 이 CLI를 사용하지 마세요:

• PRTG 클러스터 또는 API v2를 지원하지 않는 PRTG Hosted Monitor 설치(Paessler는 클러스터에서 API v2를 지원하지 않음); PRTG 웹 인터페이스 또는 레거시 v1 HTTP API를 사용하세요.
• 알림 트리거 편집, 이벤트 로그 또는 티켓 읽기에는 사용하지 마세요. API v2가 아직 이를 노출하지 않습니다.
• PRTG 서버 자체 구성(설치, 업그레이드, 코어 설정)에는 사용하지 마세요.

알려진 제한 사항

• fleet alarms, fleet handoff, fleet silenced, fleet drift는 PRTG의 타입화된 목록 엔드포인트(/sensors/alarms, /sensors, /devices, /groups, /probes)를 읽습니다. Paessler는 이를 /experimental/*을 위해 더 이상 사용하지 않는다고 표시했지만, 제거 버전 없이 여전히 제공하며 24.3 이전 코어에서도 작동합니다. sync도 동일한 목록을 읽습니다.
• 플릿 명령은 실제 PRTG 설치가 아닌 모의 코어를 대상으로 검증되었습니다.
• PRTG API v2는 PRTG 클러스터에서 사용할 수 없습니다. Hosted Monitor 지원은 버전에 따라 다릅니다.

고유 기능

모든 코어에 대한 단일 보기

• fleet alarms - 모든 클라이언트의 PRTG 코어에서 다운, 경고 및 비정상 센서를 한 목록으로 확인: 최악의 상태부터(다운, 경고, 비정상, 승인됨), 그 다음 높은 우선순위, 가장 오래된 순으로 정렬.

  교대 시작 시 또는 클라이언트 간 고장 상황을 물을 때 사용하세요.

  prtg-cli fleet alarms --status down --unacked --agent
  

• fleet status - 클라이언트 코어당 한 행으로, 연결 가능성과 상태별 센서 수를 표시하며 최악 순으로 정렬.

  자세히 살펴보기 전에 모든 클라이언트의 빠른 상태를 확인할 때 사용하세요.

  prtg-cli fleet status --agent
  

• fleet handoff - 특정 시점 이후 모든 코어에서 변경된 사항: 새 알람, 복구, 새로운 승인 또는 일시 중지(담당자 및 이유 포함).

  교대 인계 및 '밤새 무슨 일이 있었나요?' 질문에 사용하세요.

  prtg-cli fleet handoff --since 12h --agent
  

• fleet silenced - 모든 코어에서 누군가가 일시 중지하거나 승인한 모든 항목(담당자, 시간, 종료 시간, 이유 포함), 너무 오래 방치된 무기한 항목을 플래그로 표시.

  유지보수 기간 이후 및 주간 위생 검토에서 묵음 처리된 중단을 찾을 때 사용하세요.

  prtg-cli fleet silenced --indefinite --older-than 7d --agent
  

• fleet exec - 모든 코어에서 읽기 전용 API v2 쿼리를 실행하고 코어 열이 포함된 하나의 병합된 테이블을 반환.

  전용 플릿 명령으로 다루지 않는 교차 클라이언트 질문에 사용하세요.

  prtg-cli fleet exec /experimental/probes --agent
  

에스테이트 위생

• fleet drift - 코어 간 PRTG 에스테이트 위생: 최신 코어보다 뒤처진 버전, 만료 임박 라이선스 또는 유지보수, 센서 과다 사용, 연결 끊긴 프로브, 거부된 API 키, 연결 불가능한 서버.

  수동 스프레드시트 대신 주간 에스테이트 검토에 사용하세요.

  prtg-cli fleet drift --within 30d --agent
  

• fleet sync - 등록된 모든 코어의 오프라인 미러를 한 번에 새로고침, 각각 격리된 저장소에 저장.

  오프라인 검색이나 클라이언트 간 분석 전, 또는 cron에서 야간에 실행하세요.

  prtg-cli fleet sync --resources sensors,devices --agent
  

코어 간 안전한 작업

• fleet ack - 모든 코어에서 일치하는 다운 센서를 한 번에 승인(티켓 메시지 포함); 코어별 미리보기를 표시하고 --yes로만 전송(API 키에 승인 액세스 수준 필요).

  여러 클라이언트에 걸친 알려진 장애를 각 코어를 열지 않고 묵음 처리할 때 사용하세요.

  prtg-cli fleet ack --filter 'name = "Ping"' --message 'TKT-4411 ISP outage' --duration 2h
  

• fleet pause - 모든 코어에서 일치하는 장치, 그룹, 센서 또는 프로브를 유지보수 기간 동안 일시 중지; 코어별 미리보기를 표시하고 --yes로만 전송(쓰기 액세스 수준).

  다중 클라이언트 패치 작업 전에 각 코어의 웹 UI에서 일시 중지하는 대신 사용하세요.

  prtg-cli fleet pause --kind device --filter 'name = "fw01"' --duration 2h --message 'Patch night'
  

• fleet resume - 유지보수 후 모든 코어에서 일치하는 객체를 재개하고 선택적으로 즉시 스캔 트리거; 코어별 미리보기를 표시하고 --yes로만 전송(쓰기 액세스 수준).

  클라이언트 간 유지보수 기간을 종료하고 모든 것이 정상으로 돌아왔는지 확인할 때 사용하세요.

  prtg-cli fleet resume --kind device --filter 'name = "fw01"' --scan
  

명령어 참조

ai - AI 관리

• prtg-cli ai aistatus - PRTG AI Agent 서비스가 Windows Service Control Manager에 등록되어 있는지, 실행 중인지 반환
• prtg-cli ai analyze-aiincidents - 현재 활성화된 알람을 AI로 분석하고 잠재적 인시던트를 반환합니다. 이 엔드포인트는 실험적입니다.

autodiscoveries - 자동 검색 관리

• prtg-cli autodiscoveries - 실행 중인 모든 자동 검색 목록을 반환합니다.

autodiscoverytasks - 자동 검색 작업 관리

• prtg-cli autodiscoverytasks delete-auto-discovery-task - 지정된 자동 검색 작업을 삭제합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli autodiscoverytasks get-auto-discovery-task - 지정된 작업 ID로 자동 검색 작업을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli autodiscoverytasks list-auto-discovery-task-overview - 모든 자동 검색 작업의 개요 목록을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli autodiscoverytasks modify-auto-discovery-task - 자동 검색 작업을 패치합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli autodiscoverytasks start-auto-discovery-task - 지정된 작업 ID로 자동 검색 작업을 시작합니다. 이 엔드포인트는 실험적입니다.

channels - 채널 관리

• prtg-cli channels channels - 채널 목록을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli channels get - 채널의 메트릭과 설정을 반환합니다.
• prtg-cli channels list - 채널 목록을 반환합니다. ⚠ PRTG 24.3부터 지원 중단.
• prtg-cli channels list-measurements - 해당 채널에 대한 참조와 함께 마지막 측정값 목록을 가져옵니다. ⚠ PRTG 24.3부터 지원 중단.

core - --core 및 플릿 명령을 위한 PRTG 코어 등록

• prtg-cli core add <name> --server <host[:port]> [--tag a,b] [--insecure-tls] - 하나의 코어를 등록(또는 업데이트); 키는 PRTG_FLEET_KEYS에 <name>=<key> 형태로 저장되며 디스크에 저장되지 않음; --insecure-tls는 해당 코어에 대해서만 인증서 검사를 건너뜁니다.
• prtg-cli core list - 등록된 코어 목록과 각 키 환경 변수가 설정되었는지 여부(key_set)를 표시합니다.
• prtg-cli core remove <name> - 코어를 제거하고 로컬 미러와 캐시를 삭제합니다.

devices - 장치 관리

• prtg-cli devices create-sensor - 장치에 새 센서를 생성합니다. 'ping', 'http', 'paessler.snmp.traffic_sensor'와 같은 센서 종류를 지정합니다.
• prtg-cli devices delete - 모든 하위 센서와 채널을 포함하여 장치를 삭제합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli devices get - 장치의 메트릭과 설정을 반환합니다.
• prtg-cli devices get-icons - 장치 아이콘 목록을 반환합니다.
• prtg-cli devices get-templates-experimental - 장치 템플릿 목록을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli devices list - 장치 목록을 반환합니다. ⚠ PRTG 24.3부터 지원 중단.
• prtg-cli devices list-experimental - 장치 목록을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli devices metascan - 지정된 장치에서 지정된 센서 종류에 대해 메타스캔을 실행합니다. 일부 센서는 메타스캔을 사용합니다.
• prtg-cli devices metascan-result - 메타스캔 진행/결과를 검색합니다. 이 엔드포인트는 아직 모든 센서 종류를 지원하지 않습니다.
• prtg-cli devices multi-pause - 필터와 일치하는 모든 장치를 일시 중지합니다.
• prtg-cli devices multi-resume - 필터와 일치하는 모든 장치를 재개합니다.
• prtg-cli devices multi-scan-now - 필터와 일치하는 모든 장치의 스캔을 트리거합니다.
• prtg-cli devices trigger-autodiscovery - 지정된 장치에 대한 자동 검색을 트리거합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli devices update - 장치를 편집합니다.

groups - 그룹 관리

• prtg-cli groups create-device-for - 그룹에 새 장치를 생성합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli groups create-for - 그룹에 새 그룹을 생성합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli groups delete - 모든 하위 그룹과 장치를 포함하여 그룹을 삭제합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli groups get - 그룹의 메트릭과 설정을 반환합니다.
• prtg-cli groups list - 필터와 일치하는 모든 그룹 목록을 가져옵니다. ⚠ PRTG 24.3부터 지원 중단.
• prtg-cli groups list-experimental - 그룹 목록을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli groups multi-pause - 필터와 일치하는 모든 그룹을 일시 중지합니다.
• prtg-cli groups multi-resume - 필터와 일치하는 모든 그룹을 재개합니다.
• prtg-cli groups multi-scan-now - 필터와 일치하는 모든 그룹의 스캔을 트리거합니다.
• prtg-cli groups trigger-autodiscovery - 지정된 그룹에 대한 자동 검색을 트리거합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli groups update - 그룹을 편집합니다.

health - 상태 관리

• prtg-cli health - PRTG 애플리케이션 서버의 상태를 반환합니다.

libraries - 라이브러리 관리

• prtg-cli libraries - 필터와 일치하는 모든 라이브러리 목록을 반환합니다. ⚠ PRTG 24.3부터 지원 중단.

lookup-definitions - 조회 정의 관리

• prtg-cli lookup-definitions get-overview - 조회 정의를 반환합니다. ⚠ PRTG 24.3.100부터 지원 중단: 이 엔드포인트는 여전히 작동하지만 대체될 예정입니다.
• prtg-cli lookup-definitions list - 조회 정의 목록을 반환합니다. ⚠ PRTG 24.3부터 지원 중단.

objects - 객체 관리

• prtg-cli objects count - 각 종류의 객체가 몇 개 있는지 목록을 반환합니다.
• prtg-cli objects list - 필터와 일치하는 모든 프로브, 그룹, 장치, 센서 목록을 가져옵니다. ⚠ PRTG 24.3부터 지원 중단.
• prtg-cli objects multi-delete - 지정된 필터를 기반으로 여러 객체를 삭제합니다. 모든 하위 객체도 삭제됩니다. 이 엔드포인트는 실험적입니다.
• prtg-cli objects objects - 필터와 일치하는 모든 프로브, 그룹, 장치, 센서, 채널 목록을 반환합니다.

probe-network - 프로브 네트워크 정보

• prtg-cli probe-network <id> - 프로브의 네트워크 정보를 반환합니다.

probes - 프로브 관리

• prtg-cli probes create-auto-discovery-task - 프로브에 새 자동 검색 작업을 생성합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli probes create-device-for - 프로브에 새 장치를 생성합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli probes create-group-for - 프로브에 새 그룹을 생성합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli probes delete - 모든 하위 그룹과 장치를 포함하여 프로브를 삭제합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli probes get - 프로브의 메트릭과 설정을 반환합니다.
• prtg-cli probes list - 필터와 일치하는 모든 프로브 목록을 가져옵니다. ⚠ PRTG 24.3부터 지원 중단.
• prtg-cli probes list-experimental - 프로브 목록을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli probes multi-pause - 필터와 일치하는 모든 프로브를 일시 중지합니다.
• prtg-cli probes multi-resume - 필터와 일치하는 모든 프로브를 재개합니다.
• prtg-cli probes multi-scan-now - 필터와 일치하는 모든 프로브의 스캔을 트리거합니다.
• prtg-cli probes update - 프로브를 편집합니다.

schemas - 스키마 관리

• prtg-cli schemas get - 다른 엔드포인트에서 사용할 OAS 스키마를 반환합니다. ⚠ PRTG 24.3부터 지원 중단.
• prtg-cli schemas get-create-by-parent-id - POST 엔드포인트에서 사용할 OAS 스키마를 반환합니다.
• prtg-cli schemas get-kinds-for-parent - 지정된 부모 객체에 생성할 수 있는 모든 객체 종류 목록을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli schemas get-read-by-object-id - 특정 객체에 대한 GET 엔드포인트에서 사용할 OAS 스키마를 반환합니다.
• prtg-cli schemas get-update-by-object-id - 특정 객체에 대한 PATCH 엔드포인트에서 사용할 OAS 스키마를 반환합니다.

sensors - 센서 관리

• prtg-cli sensors clone - 센서를 복제합니다.
• prtg-cli sensors create - 새 센서를 생성합니다.
• prtg-cli sensors delete - 지정된 센서를 삭제합니다.
• prtg-cli sensors get - 센서의 메트릭과 설정을 반환합니다.
• prtg-cli sensors list - 센서 목록을 반환합니다. ⚠ PRTG 24.3부터 지원 중단.
• prtg-cli sensors list-experimental - 센서 목록을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli sensors multi-pause - 필터와 일치하는 모든 센서를 일시 중지합니다.
• prtg-cli sensors multi-resume - 필터와 일치하는 모든 센서를 재개합니다.
• prtg-cli sensors multi-scan-now - 필터와 일치하는 모든 센서의 스캔을 트리거합니다.
• prtg-cli sensors pause - 지정된 센서를 일시 중지합니다. 최소한 message가 필요합니다.
• prtg-cli sensors release - 특정 시간의 상태 기록 지점을 추가하고 해당 시점의 데이터를 볼륨 카운터 및 트래픽 센서에 저장합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli sensors replace - 센서의 모니터링 구성을 다른 것으로 교체합니다.
• prtg-cli sensors resume - 지정된 센서를 재개합니다.
• prtg-cli sensors scan-now - 지정된 센서의 스캔을 트리거합니다.
• prtg-cli sensors set-property - 채널에 대한 게이트 또는 제한 값을 지정합니다.
• prtg-cli sensors simulate-error-code - 지정된 오류 코드로 센서 시뮬레이션을 트리거합니다.
• prtg-cli sensors toggle-maintenance - 지정된 센서의 유지보수 모드를 전환합니다.
• prtg-cli sensors update - 센서를 업데이트합니다.
• prtg-cli sensors update-channel - 채널 설정 또는 메트릭을 업데이트합니다.
• prtg-cli sensors update-channels - 단일 센서에 대한 여러 채널 설정 또는 메트릭을 업데이트합니다.
• prtg-cli sensors update-description - 센서의 설명을 업데이트합니다.
• prtg-cli sensors update-property - 센서에 대한 지정된 속성을 업데이트합니다.

servicenow - ServiceNow 관리

• prtg-cli servicenow forward-servicenow - ServiceNow 티켓을 생성하거나 업데이트합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli servicenow servicenow-configuration - ServiceNow 구성을 반환합니다.

servicedesk - 서비스 데스크 관리

• prtg-cli servicedesk create - 서비스 데스크 티켓을 생성합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli servicedesk delete - 서비스 데스크 티켓을 삭제합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli servicedesk messages - 서비스 데스크 티켓에 대한 메시지를 반환합니다.
• prtg-cli servicedesk state - 서비스 데스크 티켓의 상태를 반환합니다.
• prtg-cli servicedesk update - 서비스 데스크 티켓의 상태를 업데이트합니다. 이 엔드포인트는 실험적입니다.

status - 상태 관리

• prtg-cli status - PRTG 애플리케이션 서버의 상태를 반환합니다.

tickets - 티켓 관리

• prtg-cli tickets add-message - 현재 티켓에 추가 메시지를 추가합니다.
• prtg-cli tickets add-ticket - 새 티켓을 추가합니다.
• prtg-cli tickets close-ticket - 티켓을 마감합니다.
• prtg-cli tickets list - 티켓 목록을 반환합니다.
• prtg-cli tickets open-ticket - 티켓을 엽니다.

values - 값 관리

• prtg-cli values get - 센서 채널의 값, 상태 및 단위를 반환합니다.
• prtg-cli values histogram - 지정된 기간 동안 센서 채널의 값을 반환합니다.
• prtg-cli values history - 마지막 측정값의 기록 데이터를 반환합니다.
• prtg-cli values table - 테이블에 대한 값을 반환합니다.

messages - 메시지 관리

• prtg-cli messages acknowledge - 지정된 메시지를 승인합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli messages list - PRTG 메시지를 반환합니다.
• prtg-cli messages list-experimental - PRTG 메시지 목록을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli messages read - 주어진 ID를 가진 메시지를 반환합니다. 이 엔드포인트는 실험적입니다.

reports - 보고서 관리

• prtg-cli reports - 보고서 목록을 반환합니다. ⚠ PRTG 24.3부터 지원 중단.
• prtg-cli reports download - 기존 보고서를 다운로드합니다.
• prtg-cli reports list-experimental - 실행 가능한 보고서 목록을 반환합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli reports run-or-schedule - 보고서를 예약하거나 즉시 실행합니다. 이 엔드포인트는 실험적입니다.
• prtg-cli reports schedule - 보고서 일정을 설정합니다. 이 엔드포인트는 실험적입니다.

users - 사용자 관리

• prtg-cli users add - 새 사용자를 생성합니다.
• prtg-cli users current - 현재 인증된 사용자에 대한 정보를 반환합니다.
• prtg-cli users delete - PRTG 사용자를 삭제합니다.
• prtg-cli users get-profile - 사용자 프로필을 반환합니다.
• prtg-cli users list - 모든 PRTG 사용자 목록을 반환합니다.
• prtg-cli users remove-profile-picture - 사용자 프로필 사진을 제거합니다.
• prtg-cli users set-profile-picture - 사용자 프로필 사진을 설정합니다.
• prtg-cli users update-profile - 사용자 프로필을 업데이트합니다.

maps - 지도 관리

• prtg-cli maps get - 지도 개체를 검색합니다.
• prtg-cli maps get-status-layer - 지도 상태 레이어를 검색합니다.
• prtg-cli maps list - 모든 지도 목록을 반환합니다. ⚠ PRTG 24.3부터 지원 중단.

자세한 내용

• mcp-install.md - MCP 서버 구성
• prtg-cli readme - 전체 prtg-cli 문서