---
title: vector — 고성로그·메트릭 파이프라인
date: 2026-10-18
time: 12:00
model: admin
category: programs
author_type: human
summary: Datadog에서 오픈소스로 배포한 고성능 데이터 파이프라인입니다. 로그·메트릭을 수집·변환·송출합니다.
tags: 프로그램, 서버 로그 기록 및 분석, vector
---

**💬 "vector 명령어"**

vector는 **고성로그·메트릭 파이프라인** Datadog에서 오픈소스로 배포한 고성능 데이터 파이프라인입니다. 로그·메트릭을 수집·변환·송출합니다.

Rust 기반이라 Fluentd 대비 3~10배 빠릅니다. 로그·메트릭·트레이스를 하나의 바이너리로 처리합니다.

- **개념**: Rust 기반이라 Fluentd 대비 3~10배 빠릅니다.
- **주요 기능**: 로그·메트릭·트레이스를 하나의 바이너리로 처리합니다.
- **장점**: TOML 기반 간단한 설정을 씁니다.
- **활용**: HTTP·Kafka·S3·Elasticsearch·Datadog 등 다양한 소스·싱크를 지원합니다.
## 설치 및 다운로드

vector는 패키지 매니저 또는 공식 스크립트로 설치합니다.

| 환경 | 명령 |
| --- | --- |
| 공식 스크립트 | curl --proto '=https' --tlsv1.2 -sSf https://sh.vector.dev | sh |
| Ubuntu / Debian | sudo apt install vector |
| RHEL / Fedora | sudo dnf install vector |
| Docker | docker run timberio/vector |
| 확인 | vector --version |

설치 확인은 `vector --version`으로 합니다.

## 자주 쓰는 옵션

| 옵션 | 설명 |
| --- | --- |
| vector --config <file> | 설정 파일을 지정합니다 |
| vector validate | 설정을 검증합니다 |
| vector top | 실시간 처리를 모니터링합니다 |
| vector list | 구성된 소스·싱크를 확인합니다 |
| vector generate | 설정 템플릿을 생성합니다 |

## 필수 명령어 조합 3가지

- `vector validate --config /etc/vector/vector.toml` — 설정 검증
- `vector top` — 실시간 처리량·오류 모니터링
- `vector tap <source>` — 소스 데이터 미리보기
**💬 "실제 서버에서 vector를 사용하는 예시를 보여줘"**

실제 운영 중인 서버에서 자주 만나는 상황을 순서대로 정리했습니다.

### 1단계 · 설치 확인

설치 여부를 확인합니다.

```
vector --version || curl --proto '=https' --tlsv1.2 -sSf https://sh.vector.dev | sh
```

### 2단계 · 설정 검증

vector.toml 설정을 검증합니다.

```
sudo vector validate --config /etc/vector/vector.toml
```

### 3단계 · 모니터링

실시간 처리를 확인합니다.

```
sudo vector top
```

## 실제 실행 화면

vector.toml 설정을 작성하고 검증한 결과입니다.

![vector 명령어 실행 결과](https://games.cursorai.co.kr/assets/vector-demo.png)

실제 운영 중인 서버

## 실무에서는 이렇게 씁니다

### 1. nginx 로그 수집 설정

**상황** — nginx access 로그를 수집합니다.

```
[sources.nginx]\ntype = "file"\ninclude = ["/var/log/nginx/access.log"]
```

**결과** — 로그 파일이 소스로 등록됩니다.

**포인트** — 파일과 Elasticsearch에 동시 송출 가능합니다.

### 2. 실시간 모니터링

**상황** — 처리량을 모니터링합니다.

```
sudo vector top
```

**결과** — nginx 소스에서 142 events/s가 처리됩니다.

**포인트** — 실시간 병목 확인이 가능합니다.

## 실제 실행 화면

vector top으로 실시간 처리를 모니터링한 결과입니다.

![vector 명령어 실행 결과 2](https://games.cursorai.co.kr/assets/vector-demo2.png)

실제 운영 중인 서버

## 주의할 점

- Vector은 아직도 빠르게 변하고 있습니다. 설정 형식이 버전에 따라 달라질 수 있습니다.
- VRL은 강력하지만 학습 곡선이 있습니다. 단순 변환부터 시작합니다.
- 대량 로그 환경에서는 디스크 버퍼(buffer) 설정이 필수입니다. 송신 지연 시 로그 유실을 방지합니다.

---
원문(HTML): https://games.cursorai.co.kr/programs/linux/logs/vector.html