WinCC Alarm Archive

The WinCC Alarm Archive adapter reads Siemens WinCC alarm archives exported as CSV files.

It is intended for the WinCC alarm CSV structure and for both archive modes:

• single archive file
• segmented circular log with multiple rotating CSV segments

Configuration is Siemens-specific:

• archive directory
• archive base name
• segmented circular log enabled or disabled
• segment count in segmented circular log mode
• segment start index
• whether the last modified timestamp should be considered for deduplication
• polling interval
• optional delay between replayed events in milliseconds
• timezone used when WinCC TimeString must be converted to Unix time

The adapter assumes the WinCC alarm CSV layout with a header row and semicolon-separated columns. The configured base name should not include the segment number or file suffix. For example, use Meldungsarchiv to match Meldungsarchiv1.csv or Meldungsarchiv0.csv to MeldungsarchivN.csv, depending on the configured segment start index.

In segmented circular log mode the adapter treats reused file names as new generations by fingerprinting file content, so a segment like Meldungsarchiv1.csv can be consumed again after WinCC rotates the archive.

If another process periodically recopies the same archive files into the watched folder, you can disable the last modified timestamp check so unchanged content is not treated as a new generation only because the file timestamp changed.

Use the inter-event delay when consumers or brokers cannot handle large replay bursts. A value like 1 ms can reduce event loss on slower consumers, while 0 disables throttling.

Set the timezone to the timezone used by the WinCC system that created the archive. The default uses the timezone of the extension runtime host at configuration time, but making it explicit avoids different timestamps after moving the adapter to another server.

The configured directory must be reachable from the extension runtime process or container.