---
title: "에이전트 문제"
slug: "cla-troubleshoot-agent"
updated: 2026-09-17T09:07:51Z
published: 2026-09-17T09:07:51Z
canonical: "guide.ncloud-docs.com/cla-troubleshoot-agent"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 에이전트 문제

Classic/VPC 환경에서 이용 가능합니다.

Cloud Log Analytics를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오.

## 에이전트 설정 파일 누락

Windows Server 2019에서 에이전트 설치 중 설정 파일 누락 오류가 발생합니다.

#### 원인

에이전트 설치 시 filebeat 또는 winlogbeat의 설정 파일이 자동으로 다운로드됩니다. 파일 다운로드가 실패하면 설정 파일이 생성되지 않아 오류가 발생하고, 로그도 전송되지 않습니다.

#### 해결 방법

해결 방법은 다음과 같습니다.

1. 설정 파일이 존재하는지 확인해 주십시오. 설정 파일 경로는 다음과 같습니다.

```
C:\Program Files\cla_windows\winlogbeat-<버전>-windows-x86_64\winlogbeat.yml
```
2. 설정 파일이 없는 경우, 서비스를 중지하고 기존 설치 파일을 삭제해 주십시오.

```
Stop-Service filebeat
Stop-Service winlogbeat
cd "C:\Program Files"
del cla_windows
```
3. 에이전트 설치 스크립트를 다시 실행해 주십시오.

```
filebeat.yml
winlogbeat.yml
```
4. 설정 파일 내용을 확인해 주십시오. 설정 파일에 서버가 위치한 리전의 수집 서버 주소(`hosts`)가 포함되어 있어야 합니다. 설정 파일이 비어 있거나 수집 서버 주소가 없으면 로그 수집이 실패할 수 있습니다.

| 리전 | VPC | Classic |
| --- | --- | --- |
| 한국 | `hosts: ["collect.vcla.ntruss.com:5043"]` | `hosts: ["collect.cla.ntruss.com:5043"]` |
| 싱가포르 | `hosts: ["sgn-collect.vcla.ntruss.com:5043"]` | `hosts: ["sgn-collect.cla.ntruss.com:5043"]` |
| 일본 | `hosts: ["jpn-collect.vcla.ntruss.com:5043"]` | `hosts: ["jpn-collect.cla.ntruss.com:5043"]` |
5. 설정 파일 확인이 완료되면 서비스를 시작해 주십시오.

```
Start-Service winlogbeat
Start-Service filebeat
```
6. 위 항목을 모두 확인한 후에도 문제가 지속되는 경우, 오류 메시지와 로그 파일을 첨부하여 고객 지원으로 문의해 주십시오.

참고

이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.