---
title: "에이전트 문제"
slug: "cla-troubleshoot-agent"
updated: 2026-05-21T09:01:46Z
published: 2026-05-21T09:03:16Z
canonical: "guide-gov.ncloud-docs.com/cla-troubleshoot-agent"
---

> ## 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 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: ["collect.vcla.gov-ntruss.com:5043"]
```
  - 설정 파일 내에 다음과 같이 수집 서버 주소(hosts)가 포함되어 있어야 합니다. 설정 파일이 비어있거나 수집 서버 주소가 없다면, 로그 수집이 실패할 수 있습니다.
5. 설정 파일 확인이 완료되면 서비스를 재시작해 주십시오.

```
Start-Service winlogbeat
Start-Service filebeat
```
6. 지속적으로 문제가 발생할 경우, 오류 메시지나 로그 파일 경로를 고객 센터에 제공해 주십시오.

참고

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