Skip to content

Commit e23390f

Browse files
committed
Hid OTLP updates
1 parent 89f252c commit e23390f

File tree

2 files changed

+18
-8
lines changed

2 files changed

+18
-8
lines changed
Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Token-Based Authentication for Secure HTTPS Log and Metric Sources (Collection)
2+
title: Token-Based Authentication for Secure HTTPS Logs and Metric Source (Collection)
33
image: https://assets-www.sumologic.com/company-logos/_800x418_crop_center-center_82_none/SumoLogic_Preview_600x600.jpg?mtime=1617040082
44
keywords:
55
- http source
@@ -9,9 +9,8 @@ hide_table_of_contents: true
99

1010
import useBaseUrl from '@docusaurus/useBaseUrl';
1111

12-
We're excited to introduce secure token-based authentication for HTTPS and OTLP sources. This new capability allows you to authenticate using a unique token in the request header, maintaining the existing HTTPS endpoint behavior while adding token validation per source.
12+
We're excited to introduce secure token-based authentication for the HTTP Logs and Metrics Source. This new capability allows you to authenticate using a unique token in the request header, maintaining the existing HTTPS endpoint behavior while adding token validation per source.
1313

1414
Obtain the token to use in an auth header when you configure an HTTP source or regenerate the URL. To learn more, see:
1515
* [Configure an HTTP Logs and Metrics Source](/docs/send-data/hosted-collectors/http-source/logs-metrics/#configure-an-httplogs-and-metrics-source)
16-
* [Create an OTLP/HTTP Source](/docs/send-data/hosted-collectors/http-source/otlp/#create-an-otlphttpsource)
1716
* [Generate a New URL for an HTTP Source](/docs/send-data/hosted-collectors/http-source/generate-new-url/)

docs/send-data/hosted-collectors/http-source/otlp.md

Lines changed: 16 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -36,11 +36,14 @@ To configure an OTLP/HTTP Source:
3636
* **Timestamp Format**. By default, Sumo Logic will automatically detect the timestamp format of your logs. However, you can manually specify a timestamp format for a Source. See [Timestamps, Time Zones, Time Ranges, and Date Formats](/docs/send-data/reference-information/time-reference for more information.
3737
1. [Create any Processing Rules](/docs/send-data/collection/processing-rules/create-processing-rule) you'd like for the OTLP/HTTP Source. <br/><img src={useBaseUrl('img/send-data/OTLP-processing-rules.png')} alt="OTLP processing rules" style={{border: '1px solid gray'}} width="400" />
3838
1. When you are finished configuring the Source, click **Save**.
39+
40+
<!-- Per DOCS-1142. Add the following once we support OTLP:
3941
1. In the **HTTP Source Address** dialog box, select one of the following to copy the URL where the source data will be stored:
4042
* **Presigned URL**. Select to copy a presigned URL with embedded authentication.<br/><img src={useBaseUrl('img/send-data/http-source-address-otlp.png')} alt="HTTP Source Address with presigned URL" style={{border: '1px solid gray'}} width="600"/>
4143
* **Auth Header**. Select to copy the URL, as well as a separate authorization header that contains an authentication token. This option provides greater security than a presigned URL because placing the authentication token in the authorization header of a request prevents the token from being exposed in the URL.<br/><img src={useBaseUrl('img/send-data/http-source-address-otlp-auth.png')} alt="HTTP Source Address with authorization header" style={{border: '1px solid gray'}} width="600"/>
4244
1. Copy the URL (and header if applicable) and keep in a safe place. You will use the URL in the next step: [Using the OTLP/HTTP Source](#using-the-otlphttp-source).
4345
1. Click **Done**.
46+
-->
4447

4548
:::note
4649
* Metrics reported with a timestamp older than 24 hours ago or newer than 24 hours in the future from the time they are reported are dropped. Make sure that the Metrics sent to OTLP Endpoint have appropriate timestamps.
@@ -72,12 +75,15 @@ The following table shows the URL format based on data types.
7275

7376
To use the URL, include the URL in otlphttp exporter of OpenTelemetry Collector and refer it in the pipelines, as needed. The exporter will automatically attach the signal type suffix:
7477

78+
<!-- Per DOCS-1142. Add the following after the line "endpoint: <source_url>" once we support OTLP:
79+
headers:
80+
Authorization: "x-sumo-token: [TokenString]"
81+
-->
82+
7583
```
7684
exporters:
7785
otlphttp:
7886
endpoint: <source_url>
79-
headers:
80-
Authorization: "x-sumo-token: [TokenString]"
8187
8288
...
8389
@@ -94,22 +100,27 @@ service:
94100
exporters: [otlphttp]
95101
```
96102

103+
<!-- Per DOCS-1142. Add the following after we support OTLP:
97104
:::note
98105
In the above example, the authorization header value is obtained when you select **Auth Header** when you [Create an OTLP/HTTP Source](#create-an-otlphttpsource), or when you [regenerate the URL](/docs/send-data/hosted-collectors/http-source/generate-new-url/).
99106
:::
107+
-->
100108

101109
### Alternative
102110

103-
It is also possible to optionally configure per-signal URL, e.g.
111+
It is also possible to optionally configure per-signal URL, for example:
112+
113+
<!-- Per DOCS-1142. Add the following after the line "logs_endpoint: <source_url>/v1/logs" once we support OTLP:
114+
headers:
115+
Authorization: "x-sumo-token: [TokenString]"
116+
-->
104117

105118
```
106119
exporters:
107120
otlphttp:
108121
traces_endpoint: <source_url>/v1/traces
109122
metrics_endpoint: <source_url>/v1/metrics
110123
logs_endpoint: <source_url>/v1/logs
111-
headers:
112-
Authorization: "x-sumo-token: [TokenString]"
113124
114125
...
115126

0 commit comments

Comments
 (0)