--- title: "일반적인 문제" slug: "cloudinsight-troubleshoot-common" tags: ["agent", "cloud insight", "데이터 수집 오류", "문제 해결"] updated: 2026-05-21T09:01:46Z published: 2026-05-21T09:03:16Z canonical: "guide-gov.ncloud-docs.com/cloudinsight-troubleshoot-common" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 일반적인 문제 Classic/VPC 환경에서 이용 가능합니다. Cloud Insight 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오. ## 서버 응답 없음 서버가 전혀 응답하지 않고(서버 Hang 상태) Metric 수집도 되지 않고 알림도 오지 않습니다. #### 원인 서버가 Hang이 걸리면 Agent가 CPU를 할당 받지 못하기 때문에 동작하지 않습니다. Hang을 발생시키는 원인인 프로세스가 Hang 상태를 스스로 해제하거나 해당 프로세스를 강제로 종료할 때까지 이 문제가 지속될 수 있습니다. #### 해결 방법 서버에 아무것도 입력되지 않을 경우, 서버를 강제로 재기동해야 할 수 있습니다. 서버가 Hang, Agent, 네트워크 이슈 등으로 정상 동작하지 않을 경우, Server(Classic) 또는 Server(VPC)의 `agent_status` Metric을 사용하여 확인해 주십시오. ## 데이터가 수집되지 않음 Agent가 정상적으로 실행 중인데 Cloud Insight에 데이터가 수집되지 않습니다. #### 원인 Agent가 정상적으로 실행 중이더라도 서버 내부 방화벽 설정, 보안 솔루션 설치 등으로 인해 Agent에서 Cloud Insight로 Outbound 통신이 막혀 있을 수 있습니다. #### 해결 방법 다음 포트 목록을 확인한 후 방화벽 해제 여부를 확인해 주십시오. **Classic 환경** | 소스 | 목적지 | 포트 | 설명 | | --- | --- | --- | --- | | 고객 VM 대역 | real-collector.nsight.gov-ncloud.com (10.250.110.145)​​​ | TCP 9973 | Nsight2 collector | | 고객 VM 대역 | real-ntp.nsight.gov-ncloud.com (10.250.110.99) | ​​​UDP 123 | Nsight2 ntp | | 고객 VM 대역 | real-wai.nsight.gov-ncloud.com (10.250.110.103)​​​ | TCP 10280 | Nsight2 wai | | 고객 VM 대역 | real-repo.nsight.gov-ncloud.com (10.250.110.104)​​ | TCP 80,443 | Nsight2 api(agent repository) | | 10.250.110.27 | 고객 VM 대역 | ICMP | Nsight2 health monitor | | 10.250.110.28 | 고객 VM 대역 | ICMP | Nsight2 health monitor | **VPC 환경** | 소스 | 목적지 | 포트 | 설명 | | --- | --- | --- | --- | | 고객 VM 대역 | collector.nsight.gov-ncloud.com (169.254.170.17) | TCP 9973 | Nsight2 collector | | 고객 VM 대역 | ntp.nsight.gov-ncloud.com (169.254.170.19) | UDP 123 | Nsight2 ntp | | 고객 VM 대역 | wai.nsight.gov-ncloud.com (169.254.170.18) | TCP 10280 | Nsight2 wai | | 고객 VM 대역 | repo.nsight.gov-ncloud.com (169.254.170.16) | TCP 80,443 | Nsight2 api(agent repository) | | 169.254.170.22 | 고객 VM 대역 | ICMP | Nsight2 health monitor | | 169.254.170.23 | 고객 VM 대역 | ICMP | Nsight2 health monitor | ## 서비스 데이터가 조회되지 않음 네이버 클라우드 플랫폼의 서비스 데이터가 대시보드에서 조회되지 않습니다. #### 원인 네이버 클라우드 플랫폼의 각 서비스에서 기본으로 제공하는 Basic Metric은 Cloud Insight에서 별다른 설정 없이 조회할 수 있습니다. 추가로 제공되는 Extended Metric은 각 서비스의 콘솔에서 별도로 설정해야 합니다. #### 해결 방법 - 각 서비스에서 제공하는 Basic/Extended Metric은 API 가이드의 [서비스 목록](https://api.ncloud-docs.com/docs/management-cloudinsight-productinfo)에서 확인할 수 있습니다. - Server(VPC)는 상세 모니터링 설정 메뉴에서 설정할 수 있습니다. 자세한 내용은 [상세 모니터링 설정](/docs/cloudinsight-start#Server%EC%9D%98%EC%83%81%EC%84%B8%EB%AA%A8%EB%8B%88%ED%84%B0%EB%A7%81%EC%8B%A0%EC%B2%ADVPC)을 참조해 주십시오. - Extended Metric은 설정 시점부터 수집됩니다. Cloud Insight에서 조회 기간을 정확하게 설정했는지 확인해 주십시오 ## 액션으로 ASG 정책 등록 시 서버가 지속적으로 생성/삭제됨 ASG 정책을 액션으로 등록했을 때 서버가 지속적으로 생성/삭제됩니다. #### 원인 Event Rule 생성 시 액션으로 ASG 정책을 설정한 경우, Event 발생 시 ASG 정책을 실행합니다. 이때 ASG 정책의 쿨다운 타임을 두고 계속해서 정책이 실행되며, Event가 종료되면 해당 정책 실행이 종료됩니다. #### 해결 방법 Event가 종료되기 전까지 서버가 지속적으로 생성되거나 삭제될 수 있습니다. ## 생성한 Custom Schema가 조회되지 않음 Custom Schema를 생성했는데 콘솔에서 조회되지 않습니다. #### 원인 생성된 Custom Schema로 데이터가 수집되어야 콘솔에서 확인할 수 있습니다. #### 해결 방법 데이터 전송은 [SendData API](https://api-gov.ncloud-docs.com/docs/management-cloudinsight-senddata)를 참조해 주십시오. 데이터 수집이 시작된 후 Custom Schema 생성 시 설정한 집계 주기(Interval)에 따라 일정 시간이 지난 후에 데이터를 조회할 수 있습니다. ## API로 보낸 데이터가 조회되지 않음 API로 데이터를 보냈는데 콘솔에서 조회되지 않습니다. #### 원인 데이터를 조회할 때 기본으로 설정되어 있는 기간이 잘못 설정되었을 가능성이 높습니다. #### 해결 방법 Cloud Insight에서 데이터를 조회할 때 기본으로 설정되어 있는 기간은 조회 시점으로부터 1시간 이전입니다. API로 데이터를 보낸 시점이 포함되도록 기간을 설정한 후 조회해 주십시오. ## API로 보낸 데이터와 대시보드에서 조회되는 결과가 상이함 API로 보낸 데이터와 대시보드에서 조회되는 결과가 다릅니다. #### 원인 Cloud Insight에서는 수집된 데이터를 일정 주기마다 여러 집계 함수를 이용하여 연산합니다. 연산된 결과가 조회되기 때문에 API로 보낸 데이터와 대시보드에 표시되는 데이터가 다르게 표시될 수 있습니다. #### 해결 방법 집계 주기와 집계 함수는 [Custom Schema 생성](/docs/cloudinsight-use-customschema#CustomSchema%EC%83%9D%EC%84%B1) 시 설정할 수 있습니다. ## Agent가 설치되지 않음 Agent가 정상적으로 설치되지 않았습니다. #### 해결 방법 Agent 정상적으로 설치되지 않은 경우, 다음과 같은 방법으로 Agent를 재설치할 수 있습니다. **Linux** 1. Agent를 중지하기 위해 `/home1/nbpmon/agent_controller_linux/stop_agent.sh`를 실행해 주십시오. 2. Agent를 삭제하기 위해 `/home1/nbpmon/agent_controller_linux/uninstall_agent.sh`를 실행해 주십시오. 3. Agent 설치 경로를 삭제하기 위해 `/home1/nbpmon/agent_controller_linux`를 삭제해 주십시오. 필요한 파일이 있다면 백업해 주십시오. 4. Agent 설치를 설치해 주십시오. - Agent 설치 방법은 [Agent 설치](/docs/cloudinsight-faq#q-agent%EB%A5%BC-%EC%84%A4%EC%B9%98%ED%95%98%EB%A0%A4%EB%A9%B4-%EC%96%B4%EB%96%BB%EA%B2%8C-%ED%95%B4%EC%95%BC-%ED%95%98%EB%82%98%EC%9A%94)를 참조해 주십시오. **Window** 1. Agent를 중지하기 위해 다음 명령을 실행해 주십시오. ``` C:\Program Files(x86)\NBP\agent_controller_windows\agent.bat stop ``` 2. Agent를 삭제하기 위해 아래 명령을 실행해 주십시오. ``` C:\Program Files (x86)\NBP\agent_controller_windows\agent.bat uninstall ``` 3. Agent 설치 경로를 삭제하기 위해 `C:\Program Files (x86)\NBP\agent_controller_windows`를 삭제해 주십시오. 필요한 파일이 있다면 백업해 주십시오. 4. Agent 설치를 설치해 주십시오. - Agent 설치 방법은 [Agent 설치](/docs/cloudinsight-faq#q-agent%EB%A5%BC-%EC%84%A4%EC%B9%98%ED%95%98%EB%A0%A4%EB%A9%B4-%EC%96%B4%EB%96%BB%EA%B2%8C-%ED%95%B4%EC%95%BC-%ED%95%98%EB%82%98%EC%9A%94)를 참조해 주십시오. 참고 이 가이드에서 원하는 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.