Skip to content

Commit 9605aa2

Browse files
committed
Fixes from the comments PR:5566
1 parent e75b65b commit 9605aa2

File tree

14 files changed

+36
-20
lines changed

14 files changed

+36
-20
lines changed

docs/reuse/apps/opentelemetry/logs-advance-option-otel.md

Lines changed: 0 additions & 5 deletions
This file was deleted.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
**Timestamp Parsing**. You can configure timestamp parsing for logs ingested using this source template. For more information, see [Timestamps, Time Zones, and Date Formats for the OpenTelemetry collector](/docs/send-data/opentelemetry-collector/remote-management/source-templates/otrm-time-reference).

docs/send-data/opentelemetry-collector/remote-management/source-templates/apache/index.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,9 @@ In this step, you will configure the yaml required for Apache Collection. Below
7777
- **Error file log path**. Enter the path to the error log file for your Apache instance.
7878
- **Fields/Metadata**. You can provide any customer fields to be tagged with the data collected. By default, sumo tags `_sourceCategory` with the value otel/apache user needs to provide the value for `webengine.cluster.name`.
7979

80-
**Timestamp Parsing**. You can do timestamp parsing for log ingested using this source template. For more details, refer to [Timestamps, Time Zones, and Date Formats](/docs/send-data/opentelemetry-collector/remote-management/source-templates/otrm-time-reference) for OpenTelemetry collector.
80+
import TimestampParsing from '../../../../../reuse/apps/opentelemetry/timestamp-parsing.md';
81+
82+
<TimestampParsing/>
8183

8284
**Processing Rules**. You can add **processing rules** for logs/metrics collected. To learn more, refer to [Processing Rules](../../processing-rules/index.md).
8385

docs/send-data/opentelemetry-collector/remote-management/source-templates/docker/index.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -77,7 +77,9 @@ In this step, you will configure the yaml required for Docker Collection. Below
7777
- **Excluded Image List**. A list of strings, [regexes](https://golang.org/pkg/regexp/), or [globs](https://github.com/gobwas/glob) whose referent container image names will not be among the queried containers for scrapping metrics. Learn more about [*excluded_images*](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/receiver/dockerstatsreceiver/README.md#configuration).
7878
- **Fields/Metadata**. You can provide any customer fields to be tagged with the data collected. By default, Sumo Logic tags `_sourceCategory` with the value otel/docker.
7979

80-
**Timestamp Parsing**. You can do timestamp parsing for log ingested using this source template. For more details, refer to [Timestamps, Time Zones, and Date Formats](/docs/send-data/opentelemetry-collector/remote-management/source-templates/otrm-time-reference) for OpenTelemetry collector.
80+
import TimestampParsing from '../../../../../reuse/apps/opentelemetry/timestamp-parsing.md';
81+
82+
<TimestampParsing/>
8183

8284
**Processing Rules**. You can add **processing rules** for logs/metrics collected. To learn more, refer to [Processing Rules](../../processing-rules/index.md).
8385

docs/send-data/opentelemetry-collector/remote-management/source-templates/elasticsearch/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,8 +78,9 @@ In this step, you will configure the yaml required for Elasticsearch collection.
7878
- **Password Environment Variable Name**. Enter the Elasticsearch password environment variable name.
7979
- **Fields/Metadata**. You can provide any customer fields to be tagged with the data collected. By default, Sumo Logic tags `_sourceCategory` with the value otel/elasticsearch user needs to provide the value for `db.cluster.name`.
8080

81-
**Timestamp Parsing**. You can do timestamp parsing for log ingested using this source template. For more details, refer to [Timestamps, Time Zones, and Date Formats](/docs/send-data/opentelemetry-collector/remote-management/source-templates/otrm-time-reference) for OpenTelemetry collector.
81+
import TimestampParsing from '../../../../../reuse/apps/opentelemetry/timestamp-parsing.md';
8282

83+
<TimestampParsing/>
8384

8485
**Processing Rules**. You can add **processing rules** for logs/metrics collected. To learn more, refer to [Processing Rules](../../processing-rules/index.md).
8586

docs/send-data/opentelemetry-collector/remote-management/source-templates/kafka/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -68,8 +68,9 @@ In this step, you will configure the yaml required for Kafka collection. Below a
6868
- **Endpoint**. The URL of the broker endpoint (default: `localhost:9092`).
6969
- **Fields/Metadata**. You can provide any customer fields to be tagged with the data collected. By default, Sumo Logic tags `_sourceCategory` with the value otel/kafka user needs to provide the value for `webengine.cluster.name`.
7070

71-
**Timestamp Parsing**. You can do timestamp parsing for log ingested using this source template. For more details, refer to [Timestamps, Time Zones, and Date Formats](/docs/send-data/opentelemetry-collector/remote-management/source-templates/otrm-time-reference) for OpenTelemetry collector.
71+
import TimestampParsing from '../../../../../reuse/apps/opentelemetry/timestamp-parsing.md';
7272

73+
<TimestampParsing/>
7374

7475
**Processing Rules**. You can add **processing rules** for logs/metrics collected. To learn more, refer to [Processing Rules](../../processing-rules/index.md).
7576

docs/send-data/opentelemetry-collector/remote-management/source-templates/localfile/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,8 +55,9 @@ In this step, you will configure the yaml required for Local File collection. Be
5555
- **Collection should begin from**. Defines where will the collection of the logs start from. Possible values are "End of File" and "Beginning of File".
5656
- **Detect messages spanning multiple lines**. You can enable this option when dealing with logs which span over multiple lines. On enabling this option you will need to specify **Boundary regex location** where you can specify if the expression defines end or start of the log line and **Expression to match message boundary** where you will define the expression.
5757

58-
**Timestamp Parsing**. You can do timestamp parsing for log ingested using this source template. For more details, refer to [Timestamps, Time Zones, and Date Formats](/docs/send-data/opentelemetry-collector/remote-management/source-templates/otrm-time-reference) for OpenTelemetry collector.
58+
import TimestampParsing from '../../../../../reuse/apps/opentelemetry/timestamp-parsing.md';
5959

60+
<TimestampParsing/>
6061

6162
**Processing Rules**. You can add processing rules for logs collected. To learn more, refer to [Processing Rules](../../processing-rules/index.md).
6263

docs/send-data/opentelemetry-collector/remote-management/source-templates/mysql/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -88,8 +88,9 @@ In this step, you will configure the yaml required for MySQL collection. Below a
8888
- **Password Environment Variable Name**. Enter the MySQL password environment variable name.
8989
- **Fields/Metadata**. You can provide any customer fields to be tagged with the data collected. By default, Sumo Logic tags `_sourceCategory` with the value otel/mysql user needs to provide the value for `db.cluster.name`.
9090

91-
**Timestamp Parsing**. You can do timestamp parsing for log ingested using this source template. For more details, refer to [Timestamps, Time Zones, and Date Formats](/docs/send-data/opentelemetry-collector/remote-management/source-templates/otrm-time-reference) for OpenTelemetry collector.
91+
import TimestampParsing from '../../../../../reuse/apps/opentelemetry/timestamp-parsing.md';
9292

93+
<TimestampParsing/>
9394

9495
**Processing Rules**. You can add **processing rules** for logs/metrics collected. To learn more, refer to [Processing Rules](../../processing-rules/index.md).
9596

docs/send-data/opentelemetry-collector/remote-management/source-templates/nginx/index.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,9 @@ In this step, you will configure the yaml required for Nginx collection. Below a
7676
- **Path to Nginx error Log file**. Enter the path to the error log file for your Nginx instance.
7777
- **Fields/Metadata**. You can provide any customer fields to be tagged with the data collected. By default sumo tags `_sourceCategory` with the value otel/nginx user needs to provide the value for `webengine.cluster.name`.
7878

79-
**Timestamp Parsing**. You can do timestamp parsing for log ingested using this source template. For more details, refer to [Timestamps, Time Zones, and Date Formats](/docs/send-data/opentelemetry-collector/remote-management/source-templates/otrm-time-reference) for OpenTelemetry collector.
79+
import TimestampParsing from '../../../../../reuse/apps/opentelemetry/timestamp-parsing.md';
80+
81+
<TimestampParsing/>
8082

8183
**Processing Rules**. You can add **processing rules** for logs/metrics collected. To learn more, refer to [Processing Rules](../../processing-rules/index.md).
8284

docs/send-data/opentelemetry-collector/remote-management/source-templates/otrm-time-reference.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn how Sumo Logic manages timestamps, time zones, and dates, and
55
keywords:
66
- time
77
- time reference
8-
- time zone
8+
- timezone
99
- time zone
1010
---
1111

@@ -15,13 +15,13 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
1515

1616
We support several options for timestamps, time zones, time ranges, and dates. When collecting log data, the timestamp attached to messages is vital, both for the integrity of the data in your account, and for accurate query results.
1717

18-
Because of the importance of timestamps, Sumo Logic indexes the timestamp of each message, making sure that data relevant to a query’s time range is returned properly in search results, which allows you to reconstruct a correct event timeline.
18+
When collecting log data, the timestamp attached to messages is critical for data integrity and accurate search results. Sumo Logic indexes the timestamp of each message to ensure results fall within the query’s time range, allowing you to reconstruct event timelines reliably.
1919

2020
## Timestamps
2121

2222
Timestamp is the part of a log message that marks the time that an event occurred. During ingestion, we can detect the message timestamp, convert it to Unix epoch time (the number of milliseconds since midnight, January 1, 1970 UTC), and index it. The timestamp is parsed either using the default timestamp parsing settings, or a custom format that you specify, including the time zone.
2323

24-
When configuring a source template, specify a custom format to parse timestamps in your log messages. 
24+
When configuring a source template, you can specify a custom format to parse timestamps in your log messages.
2525

2626
:::note
2727
Currently, only `strptime` timestamps are supported in the source templates.
@@ -42,7 +42,7 @@ OpenTelemetry Collectors can automatically parse most timestamps without any is
4242

4343
1. Perform one of the following steps:
4444
* If you're configuring a new Source template, proceed to Step 2. Or,
45-
* To edit the timestamp settings for an existing Source template, navigate to the source template. Then click on **Edit**, to the right of the Source name and go to Step 2.<br/><img src={useBaseUrl('img/send-data/source-template-edit.png')} alt="Screenshot showing the editing interface for a source template in Sumo Logic, highlighting the section for editing advanced options including timestamp settings" style={{border: '1px solid gray'}} width="400"/>
45+
* To edit the timestamp settings for an existing Source template, navigate to the source template. Then click **Edit** to the right of the Source name and go to Step 2.<br/><img src={useBaseUrl('img/send-data/source-template-edit.png')} alt="Screenshot showing the editing interface for a source template in Sumo Logic, highlighting the section for editing advanced options including timestamp settings" style={{border: '1px solid gray'}} width="400"/>
4646
1. Navigate to the **Timestamp Parsing** section and select **Specify the format** and enter the below details:
4747
1. **Select Timezone**. Define the geographic location (time zone) to use while parsing a timestamp that does not include a time zone. The available locations depend on the local IANA Time Zone database. For example, `America/New_York`. For more examples, refer to the [List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
4848
1. **Format**. Specify the exact layout of the timestamp to be parsed. For example, `- %Y-%m-%dT%H:%M:%S.%LZ`. To learn more about the formatting rules, refer to [this guide](https://github.com/open-telemetry/opentelemetry-collector-contrib/blob/main/internal/coreinternal/timeutils/internal/ctimefmt/ctimefmt.go#L68).
@@ -142,7 +142,7 @@ The following conventions are some examples of the supported formats for `strpti
142142

143143
The following considerations apply to time zones:
144144

145-
We highly recommend that the time zone be set explicitly on any source template where the logs does not have a time zone available. Sumo Logic always attempts to determine the time zone for the Source. However, if that is not possible, the time zone will revert to UTC. In these cases, the time zone will be incorrect, and that could significantly affect forensic analysis and reporting.
145+
We highly recommend that the time zone be set explicitly on any source template where the logs do not have a time zone available. Sumo Logic always attempts to determine the time zone for the Source. However, if that is not possible, the time zone will revert to UTC. In these cases, the time zone will be incorrect, and that could significantly affect forensic analysis and reporting.
146146

147147
### Default time zone
148148

0 commit comments

Comments
 (0)