[en] Server Logs
참고
[en] This article describes the Server Logs functionality introduced in 2026 R1, which uses OpenTelemetry and VictoriaLogs. If your system uses the legacy Log Server, refer to the documentation for your XProtect version instead.
[en] Introduction
비디오 관리 XProtect 소프트웨어 서버 구성 요소는 시스템 활동, 이벤트 및 오류에 대한 로그 항목을 생성합니다. 이러한 로그 엔트리는 수집되어 OTLP(OpenTelemetry Protocol)를 통해 OpenTelemetry를 사용하여 전송됩니다.
[en] The OpenTelemetry Collector forwards log data to a log processing service. By default, this is VictoriaLogs.
[en] You can view system logs, audit logs, and rule logs in XProtect Management Client. From the Server Logs page, you can search, filter, and analyze log entries to investigate system activity, user actions, events, and errors.
[en] Some logging settings, including retention and collection behavior, are managed outside XProtect Management Client through the OpenTelemetry Collector and VictoriaLogs configuration files.
[en] OpenTelemetry and the OTLP protocol
[en] OpenTelemetry is an open standard for collecting and transferring telemetry data, including logs. XProtect uses the OpenTelemetry Protocol (OTLP) to send log data between components in the logging infrastructure.
[en] Using OTLP makes the logging infrastructure more flexible. In addition to the default setup with VictoriaLogs, you can connect the system to external logging or monitoring solutions that support OTLP.
OpenTelemetry에서 원격 측정 신호로 로그를 처리하는 방법에 대한 일반적인 개요는 OpenTelemetry 설명서에서 OpenTelemetry Logging을 참조하십시오https://opentelemetry.io/docs/specs/otel/logs/.
OpenTelemetry Collector 서비스입니다
서버 로그는 실행 중인 OpenTelemetry Collector 서비스가 필요합니다. XProtect 서버 구성 요소는 OpenTelemetry Protocol(OTLP)을 사용하여 수집기에 로그를 전송하고, 수집기는 로그를 VictoriaLogs 또는 외부 로깅 솔루션으로 전달합니다.
[en] The OpenTelemetry Collector receives log data from XProtect server components and forwards it to the configured log processing service. By default, this is VictoriaLogs.
[en] VictoriaLogs
[en] VictoriaLogs serves as the log database engine for XProtect logs, handling log storage, querying, and analysis. It replaces the SQL Server-based log database used in earlier versions of XProtect.
[en] You can access log data from the Server Logs page in XProtect Management Client.
[en] By default, system logs and rule logs are retained for 7 days, and audit logs are retained for 30 days. Older log entries are automatically deleted when the retention period expires. You can modify the retention settings in the VictoriaLogs configuration files stored on the Management Server. For more information, see Set log retention policy.