OvenMediaEngine Enterprise
English
English한국어
English
English한국어
  • Introduction
  • OvenMediaEngine Configuration
  • Getting Started
    • Getting Started with Ubuntu
    • Getting Started with RHEL
    • Getting Started with Docker
  • Enterprise-grade Features
    • Web Console
      • Web Console Configuration
      • Sign In
      • Change Password
      • Web Console Home
        • Stream List
      • Stream Monitoring
        • Managed and Instant Streams
        • Scheduled Channels | 0.16.4.0+
        • Multiplex Channels | 0.16.5.0+
      • Monitoring
      • Logs
      • Configuration Files
      • Settings
        • Server
        • Live Sources (Ingress Protocols)
          • RTMP | 0.9.0.0+
          • WebRTC/WHIP | 0.12.0.0+/0.15.1.0+
          • SRT | 0.12.0.0+
          • MPEG-2 TS | 0.10.4.0+
          • Scheduled Channels | 0.16.4.0+
          • Multiplex Channels | 0.16.5.0+
        • ABR and Transcoding
          • Transcoding
          • Output Profiles
          • Adaptive Bitrate Streaming (ABR) | 0.14.3.0+
          • Encodes
          • Conditional Transcoding
        • Streaming (Egress Protocols)
          • WebRTC/WHIP | 0.9.0.0+/0.15.1.0+
          • Low Latency HLS (LLHLS) | 0.14.0.0+
          • Legacy HLS | 0.16.6.0+
        • TLS Encryption | 0.14.0.0+
        • Access Control
          • Signed Policy | 0.12.0.0+
          • Admission Webhooks | 0.12.2.0+
        • Thumbnail | 0.15.7.0+
        • Recording | 0.16.5.0+
        • Push Publishing | 0.15.14.0+
        • REST API | 0.11.0.0+
        • Alert | 0.15.11.0+
      • Restart
    • Record Delivery | 0.16.5.0+
    • Digital Rights Management (DRM)
      • OvenMediaEngine Configuration for DRM | 0.16.0.0+
      • PallyCon DRM Configuration | 0.16.4.0+
    • Hardware-Accelerated Video Encoding | 0.16.4.0+
    • Proxy Protocol Integration | 0.16.6.2+
    • Event Monitoring | v0.18.1.0 +
      • Configuration
      • Event Specification
    • Advanced Management Tool
      • API Storage | 0.17.0.0+
      • Restart Application | 0.17.0.0+
      • Publisher Extension
      • RTMP Authentication | 0.17.2.0+
      • Generating Audio PTS | 0.17.2.3+
      • Inserting AMF0 messages in RTMP Push Publisher | 0.17.3.0+
      • Inserting ad markers (EXT-X-CUE-OUT/EXT-X-CUE-IN) | v0.17.3.0+
      • Inserting SEI into H.264 (AVC) Streams | v0.18.0.0+
  • Release Notes
    • 0.18.1 (Mar 28, 2025 update)
    • 0.18.0
    • 0.17.3
    • 0.17.2
    • 0.17.1
    • 0.17.0
    • 0.16.8
    • 0.16.7
    • 0.16.6
    • 0.16.5
    • 0.16.4
Powered by GitBook
On this page
  • Configuration
  • Configuration using Server.xml
  • Configuration using the Web Console
  • Post Configuration
  • Web Console Event Log Directory Setting
  • Event Specification
  1. Enterprise-grade Features
  2. Event Monitoring | v0.18.1.0 +

Configuration

Configuration

Event monitoring can be configured by modifying Server.xml or through the Web Console.

Configuration using Server.xml

To enable event monitoring, add the relevant settings to Server.xml.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<Server version="8">

 <Monitoring>
    <Events>
      <Level>info</Level>
      <Log>
        <Enabled>true</Enabled>
        <Path>/var/log/ovenmediaengine</Path>
      </Log>
    </Events>
  </Monitoring>

</Server>
parameter
required
description

<Events><Level>

N

Event logs have different levels according to operations. Configurable values are trace, debug, info, warn, error, and the default is debug.

<Events><Log><Enabled>

Y

The event logging function can be enabled or disabled with true or false.

<Events><Log><Path>

N

Specifies the directory where event log files are saved. The default directory is /var/log/ovenmediaengine.

If you modify Server.xml, you need to restart OvenMediaEngine and the Web Console.

Configuration using the Web Console

You can enable the event monitoring function through the UI on the Web Console's Settings -> Server page.

  1. Navigate to the Settings -> Server page using the navigation at the top of the screen.

  2. Set the values in the monitoring section. 2-1. level: Set the level of event logs. 2-2. Log Enabled: Set to true to enable event logging. 2-3. Log Path: Set the directory where event logs will be saved. If set to an empty value, event logs will be saved as event.log in OvenMediaEngine's default log storage directory, /var/log/ovenmediaengine.

  3. After setting the values, click the Update Changes button at the top to apply the changes.

OvenMediaEngine will automatically restart when changes are applied.

Post Configuration

Web Console Event Log Directory Setting

No additional settings are needed if you use the default directory, /var/log/ovenmediaengine.

To synchronize recorded event logs with the Web Console, you need to match the Web Console's environment variables with the configured LogPath.

You can set the changed event logging directory by adding environment variables to system.env.

OS_ENGINE_MONITORING_EVENT_PATH=/your/eventlog/directory

Event Specification

Please refer to the Event Specification document for details on the event formats and event lists recorded through event logging.

PreviousEvent Monitoring | v0.18.1.0 +NextEvent Specification

Last updated 2 days ago