diff --git a/content/momentum/4/config-options-summary.md b/content/momentum/4/config-options-summary.md index da6d525b..70b7707a 100644 --- a/content/momentum/4/config-options-summary.md +++ b/content/momentum/4/config-options-summary.md @@ -213,10 +213,10 @@ The `Version` column indicated the version(s) of Momentum that support the optio | [local_changes_only](/momentum/4/config/ref-local-changes-only) – Whether there is a file for writing local configuration change | na | false | 4.0 and later | global | | [log_active_interval](/momentum/4/modules/4-modules-cluster#option.log_active_interval) – Used to tune centralized logging (cluster-specific) | na | 1 | 4.0 and later | cluster | | [log_group](/momentum/4/modules/4-modules-cluster#option.log_group) – Whether or not panic log messages are broadcast over spread (cluster-specific) | na |   | 4.0 and later | cluster | +| [log_hires_timestamp](/momentum/4/config/ref-log-hires-timestamp) – Enable microsecond resolution for log timestamps | na | false | 5.3 and later | global | | [log_idle_interval](/momentum/4/modules/4-modules-cluster#option.log_idle_interval) – Amount of time to sleep before looking for another segment (cluster-specific) | na | 10 | 4.0 and later | cluster | | [log_requests_to_paniclog](/momentum/3/3-rest/rest-http-listener) – Whether to log REST injection requests | sending | false | 4.0 and later | http_listener, listen, pathway, pathway_group, peer | | [Logfile](/momentum/4/config/ref-eccluster-conf#eccluster.conf.logs.logfile) – Describe the full path to the log file | na |   | 4.0 and later | logs | -| [LogHiresTimestamp](/momentum/4/config/ref-log-hires-timestamp) – Enable microsecond resolution for log timestamps | na | false | 5.3 and later | global | | [logs](/momentum/4/config/ref-ecelerity-cluster-conf) – Define the location of the cluster manager logs (cluster-specific) | na |   | 4.0 and later | cluster | | [logs](/momentum/4/config/ref-eccluster-conf) *(scope)* – Configure centralized log files on the cluster manager | na |   | 4.0 and later | global | | [low_action](/momentum/4/modules/4-adaptive#modules.adaptive.low_action) – Action when the high threshold is not met but the low threshold is met | sending | "throttle" "down" | 4.0 and later | adaptive_sweep_rule | diff --git a/content/momentum/4/config/ref-log-hires-timestamp.md b/content/momentum/4/config/ref-log-hires-timestamp.md index f899a1ff..96ee7524 100644 --- a/content/momentum/4/config/ref-log-hires-timestamp.md +++ b/content/momentum/4/config/ref-log-hires-timestamp.md @@ -1,22 +1,22 @@ --- lastUpdated: "07/01/2026" -title: "LogHiresTimestamp" -description: "LogHiresTimestamp enables microsecond resolution for log timestamps written by Momentum across the mainlog, bouncelog, rejectlog, paniclog, custom logs, and other logging modules" +title: "log_hires_timestamp" +description: "log_hires_timestamp enables microsecond resolution for log timestamps written by Momentum across the mainlog, bouncelog, rejectlog, paniclog, custom logs, and other logging modules" --- ## Name -LogHiresTimestamp — enable microsecond resolution for log timestamps +log_hires_timestamp — enable microsecond resolution for log timestamps ## Synopsis -`LogHiresTimestamp = true` +`log_hires_timestamp = true` ## Description -When `LogHiresTimestamp` is set to `true`, Momentum writes log timestamps with microsecond (1 µs) resolution instead of the default 1-second resolution. +When `log_hires_timestamp` is set to `true`, Momentum writes log timestamps with microsecond (1 µs) resolution instead of the default 1-second resolution. ### Rationale @@ -48,7 +48,7 @@ The effect on each timestamp depends on how it is rendered: * **Formatted (`strftime`) timestamps.** Timestamps rendered through a `strftime(3)` format string — such as the `timestamp_format` of [chunk_logger](/momentum/4/modules/chunk-logger), the `%t{...}` macro of [custom_logger](/momentum/4/modules/custom-logger), or [timestampformat](/momentum/4/config/ref-timestampformat) — keep the configured format, but every `%S` or `%T` conversion is followed by a `.NNNNNN` six-digit microsecond fraction. For example, the default `[%a %d %b %Y %H:%M:%S] ` becomes `[%a %d %b %Y %H:%M:%S.NNNNNN] ` and renders as `[Mon 20 May 2026 14:32:17.482915] `. -When `LogHiresTimestamp` is `false` (the default), timestamps are emitted exactly as in previous releases of Momentum, with 1-second resolution and no `.NNNNNN` fraction. +When `log_hires_timestamp` is `false` (the default), timestamps are emitted exactly as in previous releases of Momentum, with 1-second resolution and no `.NNNNNN` fraction. ## Compatibility @@ -57,12 +57,12 @@ Tools that parse the numeric epoch field must accept either 10 or 16 decimal dig ## Online Modification -`LogHiresTimestamp` is not online-tunable. Changing the option requires a Momentum restart. +`log_hires_timestamp` is not online-tunable. Changing the option requires a Momentum restart. ## Scope -`LogHiresTimestamp` is valid in the global scope. +`log_hires_timestamp` is valid in the global scope. ## See Also diff --git a/content/momentum/4/config/ref-timestampformat.md b/content/momentum/4/config/ref-timestampformat.md index 6de84172..4f86c365 100644 --- a/content/momentum/4/config/ref-timestampformat.md +++ b/content/momentum/4/config/ref-timestampformat.md @@ -19,8 +19,7 @@ timestampformat — set the timestamp format used when logging to stderr Sets the timestamp format used by Momentum when logging to `stderr`. This output is usually not seen unless you invoke **ecelerity** using the `-d` option. The default value is shown above. > **Note** -> -> When [LogHiresTimestamp](/momentum/4/config/ref-log-hires-timestamp) is enabled (Momentum 5.3 and later), every `%S` or `%T` conversion in the configured format is automatically followed by a `.NNNNNN` six-digit microsecond fraction, so the default value renders as `[Mon 20 May 2026 14:32:17.482915] `. +> When [log_hires_timestamp](/momentum/4/config/ref-log-hires-timestamp) is enabled (Momentum 5.3 and later), every `%S` or `%T` conversion in the configured format is automatically followed by a `.NNNNNN` six-digit microsecond fraction, so the default value renders as `[Mon 20 May 2026 14:32:17.482915] `. ## Scope diff --git a/content/momentum/4/log-formats-bouncelog.md b/content/momentum/4/log-formats-bouncelog.md index 9d0b6ced..e1086b1e 100644 --- a/content/momentum/4/log-formats-bouncelog.md +++ b/content/momentum/4/log-formats-bouncelog.md @@ -7,8 +7,7 @@ description: "The bouncelog records both in band and out of band bounces It is c The `bouncelog` records both in-band and out-of-band bounces. It is configured in the [bounce_logger](/momentum/4/modules/bounce-logger) module. > **Note** -> -> When [LogHiresTimestamp](/momentum/4/config/ref-log-hires-timestamp) is enabled (Momentum 5.3 and later), the timestamp field at offset `0` of every record is emitted as a 16-digit microseconds-since-epoch value (for example `1064868656123456`) instead of a 10-digit seconds-since-epoch value. The field remains a single integer with no separator. +> When [log_hires_timestamp](/momentum/4/config/ref-log-hires-timestamp) is enabled (Momentum 5.3 and later), the timestamp field at offset `0` of every record is emitted as a 16-digit microseconds-since-epoch value (for example `1064868656123456`) instead of a 10-digit seconds-since-epoch value. The field remains a single integer with no separator. ### Bounce Records @@ -63,4 +62,4 @@ The following is a description of the fields: | 3 |   | Unused | | 4 | M1 | `M1` indicating a heartbeat | -Having three unused fields ensures that, like other logs, the fifth field is the log entry type. This makes parsing easier. \ No newline at end of file +Having three unused fields ensures that, like other logs, the fifth field is the log entry type. This makes parsing easier. diff --git a/content/momentum/4/log-formats-mainlog.md b/content/momentum/4/log-formats-mainlog.md index 12296621..bc0ea87a 100644 --- a/content/momentum/4/log-formats-mainlog.md +++ b/content/momentum/4/log-formats-mainlog.md @@ -11,8 +11,7 @@ Every event is written to the `mainlog` file as a single line. Fixed position co The following sections define the format for each event type. > **Note** -> -> When [LogHiresTimestamp](/momentum/4/config/ref-log-hires-timestamp) is enabled (Momentum 5.3 and later), the timestamp field at offset `0` of every record is emitted as a 16-digit microseconds-since-epoch value (for example `1064868656123456`) instead of a 10-digit seconds-since-epoch value. The field remains a single integer with no separator. +> When [log_hires_timestamp](/momentum/4/config/ref-log-hires-timestamp) is enabled (Momentum 5.3 and later), the timestamp field at offset `0` of every record is emitted as a 16-digit microseconds-since-epoch value (for example `1064868656123456`) instead of a 10-digit seconds-since-epoch value. The field remains a single integer with no separator. ### Reception Records diff --git a/content/momentum/4/log-formats-paniclog.md b/content/momentum/4/log-formats-paniclog.md index f3c15c8e..65a90340 100644 --- a/content/momentum/4/log-formats-paniclog.md +++ b/content/momentum/4/log-formats-paniclog.md @@ -11,8 +11,7 @@ Under normal circumstances, Debug_Flags should be empty or should be omitted fro In addition, Momentum logs entries to the `paniclog` when the `log_requests_to_paniclog` option is enabled in the HTTP_Listener and its nested scopes. > **Note** -> -> When [LogHiresTimestamp](/momentum/4/config/ref-log-hires-timestamp) is enabled (Momentum 5.3 and later), the leading timestamp of every record (the value preceding the `:` separator) is emitted as a 16-digit microseconds-since-epoch value (for example `1307461172123456:`) instead of a 10-digit seconds-since-epoch value. The value remains a single integer with no internal separator. +> When [log_hires_timestamp](/momentum/4/config/ref-log-hires-timestamp) is enabled (Momentum 5.3 and later), the leading timestamp of every record (the value preceding the `:` separator) is emitted as a 16-digit microseconds-since-epoch value (for example `1307461172123456:`) instead of a 10-digit seconds-since-epoch value. The value remains a single integer with no internal separator. ### Panic Records @@ -36,4 +35,4 @@ The following is a description of the fields: | 4 | HTTP/1.0 | HTTP version of the request | | 5 | 200 | HTTP response status code | | 6 | 224 | Total number of bytes of the response | -| 7 | 5.000 | Time taken from request to response in milliseconds | \ No newline at end of file +| 7 | 5.000 | Time taken from request to response in milliseconds | diff --git a/content/momentum/4/log-formats-rejectlog.md b/content/momentum/4/log-formats-rejectlog.md index 27a99281..cd0c0e54 100644 --- a/content/momentum/4/log-formats-rejectlog.md +++ b/content/momentum/4/log-formats-rejectlog.md @@ -7,8 +7,7 @@ description: "The rejectlog stores records of inbound messages that are rejected The `rejectlog` stores records of inbound messages that are rejected by Momentum, either due to policy or protocol deviations. It lists the full context for all rejected messages, as well as a summary of why the message was rejected, and it is configured in the [ec_logger](/momentum/4/modules/ec-logger). > **Note** -> -> When [LogHiresTimestamp](/momentum/4/config/ref-log-hires-timestamp) is enabled (Momentum 5.3 and later), the leading timestamp of every record (the value preceding the `:` separator) is emitted as a 16-digit microseconds-since-epoch value (for example `1236672125123456:`) instead of a 10-digit seconds-since-epoch value. The value remains a single integer with no internal separator. +> When [log_hires_timestamp](/momentum/4/config/ref-log-hires-timestamp) is enabled (Momentum 5.3 and later), the leading timestamp of every record (the value preceding the `:` separator) is emitted as a 16-digit microseconds-since-epoch value (for example `1236672125123456:`) instead of a 10-digit seconds-since-epoch value. The value remains a single integer with no internal separator. ### Rejection Records @@ -47,4 +46,4 @@ In addition to the record described in the previous section, a heartbeat is writ `1252064908: Marker 1` -The `Marker 1` entry follows the Unix timestamp and is separated from it by a space. \ No newline at end of file +The `Marker 1` entry follows the Unix timestamp and is separated from it by a space. diff --git a/content/momentum/changelog/5/5-3-0.md b/content/momentum/changelog/5/5-3-0.md index b163d299..067fc960 100644 --- a/content/momentum/changelog/5/5-3-0.md +++ b/content/momentum/changelog/5/5-3-0.md @@ -12,5 +12,5 @@ This section will list all of the major changes that happened with the release o | --- | --- | --- | | Feature | I-1064 | Added support for [license](/momentum/4/before-you-begin#momentum-license) signatures using ECDSA P-256 with SHA-256. | | Feature | I-1214 | Removed `msys-nodejs` RPM from the Momentum bundle, to be replaced with the 3rd-party `nodejs` package. Node.js LTS 24+ must be installed separately from the system or a vendor repository. | -| Feature | I-1216 | Added the [LogHiresTimestamp](/momentum/4/config/ref-log-hires-timestamp) option to emit microsecond-resolution timestamps in the `mainlog`, `bouncelog`, `rejectlog`, `paniclog`, custom logs, chunk logs, and message generation logs, preserving event ordering when reading multiple log files together. | +| Feature | I-1216 | Added the [log_hires_timestamp](/momentum/4/config/ref-log-hires-timestamp) option to emit microsecond-resolution timestamps in the `mainlog`, `bouncelog`, `rejectlog`, `paniclog`, custom logs, chunk logs, and message generation logs, preserving event ordering when reading multiple log files together. | | Fix | TASK-227757 | [`ha_proxy_client`](/momentum/4/modules/ha-proxy-client) now re-resolves a hostname-based `ha_proxy_server` during each health check, so backend IP changes are picked up automatically without restart. |