Merge remote-tracking branch 'refs/remotes/origin/otel-collector-doc' into otel-collector-doc

Author: chetanchoudhary-sumo

.clabot

@@ -188,7 +188,8 @@
     "ntanwar-sumo",
     "aj-sumo",
     "samiura",
-    "naveenrama"
+    "naveenrama",
+    "fguimond"
   ],
   "message": "Thank you for your contribution! As this is an open source project, we require contributors to sign our Contributor License Agreement and do not have yours on file. To proceed with your PR, please [sign your name here](https://forms.gle/YgLddrckeJaCdZYA6) and we will add you to our approved list of contributors.",
   "label": "cla-signed",

docs/integrations/hosts-operating-systems/opentelemetry/opentelemetry-collector-insights.md

@@ -13,7 +13,7 @@ import TabItem from '@theme/TabItem';
 
 The Sumo Logic OpenTelemetry Collector Insights app provides comprehensive monitoring and observability for your OpenTelemetry Collector instances. Monitor collector performance, telemetry data flow, resource utilization, and troubleshoot data collection issues with preconfigured dashboards and alerts. Track metrics and logs to ensure your telemetry pipeline is running smoothly and efficiently.
 
-This app supports OpenTelemetry Collector version **0.130.1-sumo-0** and later versions.
+This app supports OpenTelemetry Collector version `0.130.1-sumo-0` and later versions.
 
 We use the OpenTelemetry collector's built-in internal telemetry capabilities to collect metrics and logs about the collector itself. By default, the Collector exposes its own telemetry through internal metrics (via Prometheus interface on port 8888) and logs (emitted to stderr). The collector can also be configured to export its own telemetry data (metrics and logs) to Sumo Logic through OTLP/HTTP endpoints.
 
@@ -25,13 +25,13 @@ This app includes [built-in monitors](#opentelemetry-collector-insights-alerts).
 
 Following are the [fields](/docs/manage/fields/) which will be created as part of OpenTelemetry Collector Insights app installation, if not already present.
 
-- **sumo.datasource**. Has fixed value of **otel_collector**.
-- **_contentType**. Has fixed value of **OpenTelemetry**.
-- **deployment.environment**. User configured. Enter a name to identify your deployment environment.
+- `sumo.datasource`. Has fixed value of `otel_collector`.
+- `_contentType`. Has fixed value of `OpenTelemetry`.
+- `deployment.environment`. User configured. Enter a name to identify your deployment environment.
 
 ## Prerequisites
 
-### For OTLP Endpoint Configuration
+### For OTLP endpoint configuration
 
 Before configuring the OTEL Collector integration, ensure you have the following prerequisites in place:
 
@@ -85,10 +85,10 @@ In this step, you will configure the OpenTelemetry Collector's built-in telemetr
 The collector's service configuration needs to be updated to enable telemetry export. Below is the required configuration that should be added to your collector's service section:
 
 **Required Inputs:**
-- **OTLP Endpoint**: Your Sumo Logic OTLP endpoint URL
+- **OTLP Endpoint**: Your Sumo Logic OTLP endpoint URL.
 
 **Configuration Parameters:**
-- **Endpoint Format**: The base endpoint automatically creates:
+- **Endpoint Format**. The base endpoint automatically creates:
   - Logs endpoint: `${OTLP_ENDPOINT}/v1/logs`
   - Metrics endpoint: `${OTLP_ENDPOINT}/v1/metrics`
 
@@ -209,11 +209,11 @@ import LogsOutro from '../../../reuse/apps/opentelemetry/send-logs-outro.md';
 ### Validation
 
 After installation, verify that:
-1. The OTEL Collector service is running
-2. The configured base endpoint is reachable
-3. Data is being successfully sent to both the logs (`/v1/logs`) and metrics (`/v1/metrics`) endpoints
-4. Resource attributes are properly applied to the telemetry data
-5. Internal metrics are accessible at `http://localhost:8888/metrics`
+1. The OTEL Collector service is running.
+2. The configured base endpoint is reachable.
+3. Data is being successfully sent to both the logs (`/v1/logs`) and metrics (`/v1/metrics`) endpoints.
+4. Resource attributes are properly applied to the telemetry data.
+5. Internal metrics are accessible at `http://localhost:8888/metrics`.
 
 ## Sample log messages
 
@@ -319,10 +319,10 @@ All dashboards have a set of filters that you can apply to the entire dashboard.
 The **OpenTelemetry Collector Insights - Overview** dashboard provides a high-level view of your OpenTelemetry Collector fleet's health and performance. This is your starting point for monitoring collector instances.
 
 Use this dashboard to:
-- Monitor the overall health of your collector fleet
-- Identify performance bottlenecks and resource constraints
-- Track data flow and processing rates across collectors
-- Quickly spot collectors experiencing issues
+- Monitor the overall health of your collector fleet.
+- Identify performance bottlenecks and resource constraints.
+- Track data flow and processing rates across collectors.
+- Quickly spot collectors experiencing issues.
 
 <img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/OpenTelemetry-Collector-Insights/OpenTelemetry-Collector-Overview.png' alt="Overview" />
 
@@ -331,10 +331,10 @@ Use this dashboard to:
 The **OpenTelemetry Collector Insights - Logs** dashboard provides detailed insights into collector log output for root-cause analysis of errors, data dropping events, and restarts.
 
 Use this dashboard to:
-- Analyze error patterns and troubleshoot issues
-- Monitor collector startup and shutdown events
-- Identify data loss or processing problems
-- Track log severity trends across your collector fleet
+- Analyze error patterns and troubleshoot issues.
+- Monitor collector startup and shutdown events.
+- Identify data loss or processing problems.
+- Track log severity trends across your collector fleet.
 
 <img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/OpenTelemetry-Collector-Insights/OpenTelemetry-Collector-Logs.png' alt="Logs" />
 
@@ -343,10 +343,10 @@ Use this dashboard to:
 The **OpenTelemetry Collector Insights - Pipeline: Receiver Health** dashboard focuses exclusively on the data ingestion stage of the pipeline to monitor data sources and receiver performance.
 
 Use this dashboard to:
-- Monitor receiver performance and data ingestion rates
-- Identify issues with data sources and input connections
-- Track receiver-specific errors and failures
-- Analyze accepted vs refused data points
+- Monitor receiver performance and data ingestion rates.
+- Identify issues with data sources and input connections.
+- Track receiver-specific errors and failures.
+- Analyze accepted vs refused data points.
 
 <img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/OpenTelemetry-Collector-Insights/OpenTelemetry-Collector-Pipeline-Receiver-Health.png' alt="Pipeline Receiver Health" />
 
@@ -355,10 +355,10 @@ Use this dashboard to:
 The **OpenTelemetry Collector Insights - Pipeline: Processor Health** dashboard is crucial for understanding if any processors (like batch, memory_limiter, or resourcedetection) are dropping data or causing performance issues.
 
 Use this dashboard to:
-- Monitor processor performance and throughput
-- Identify data drops or processing bottlenecks
-- Track processor-specific configurations and health
-- Analyze batch processing efficiency and triggers
+- Monitor processor performance and throughput.
+- Identify data drops or processing bottlenecks.
+- Track processor-specific configurations and health.
+- Analyze batch processing efficiency and triggers.
 
 <img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/OpenTelemetry-Collector-Insights/OpenTelemetry-Collector-Pipeline-Processor-Health.png' alt="Pipeline Processor Health" />
 
@@ -367,10 +367,10 @@ Use this dashboard to:
 The **OpenTelemetry Collector Insights - Pipeline: Exporter Health** dashboard is the most critical dashboard for diagnosing backpressure and data loss at the egress stage of the pipeline.
 
 Use this dashboard to:
-- Monitor exporter performance and success rates
-- Identify backpressure issues and export failures
-- Track data delivery to downstream systems
-- Analyze queue utilization and capacity
+- Monitor exporter performance and success rates.
+- Identify backpressure issues and export failures.
+- Track data delivery to downstream systems.
+- Analyze queue utilization and capacity.
 
 <img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/OpenTelemetry-Collector-Insights/OpenTelemetry-Collector-Pipeline-Exporter-Health.png' alt="Pipeline Exporter Health" />
 
@@ -379,18 +379,20 @@ Use this dashboard to:
 The **OpenTelemetry Collector Insights - Resource Utilization** dashboard provides a deep dive into the collector's own resource consumption to diagnose performance issues and plan for capacity.
 
 Use this dashboard to:
-- Monitor CPU, memory, and disk usage by collectors
-- Plan capacity and resource allocation
-- Identify resource constraints and optimization opportunities
-- Track heap allocation and garbage collection patterns
+- Monitor CPU, memory, and disk usage by collectors.
+- Plan capacity and resource allocation.
+- Identify resource constraints and optimization opportunities.
+- Track heap allocation and garbage collection patterns.
 
 <img src='https://sumologic-app-data-v2.s3.amazonaws.com/dashboards/OpenTelemetry-Collector-Insights/OpenTelemetry-Collector-Resource-Utilization.png' alt="Resource Utilization" />
 
 ## Troubleshooting
 
-### Common Issues
+### Common issues
 
-**Collector connection failure**: If your collector fails to connect to Sumo Logic, you may need to configure proxy settings. Check the collector's logs for connection errors:
+##### Collector connection failure
+
+If your collector fails to connect to Sumo Logic, you may need to configure proxy settings. Check the collector's logs for connection errors:
 
 ```bash
 # On systemd systems
@@ -399,31 +401,35 @@ journalctl --unit otelcol-sumo
 # Look for errors like "Unable to get a heartbeat"
 ```
 
-**High queue utilization**: Monitor the `otelcol_exporter_queue_size` and `otelcol_exporter_queue_capacity` metrics. If the queue is consistently full, you may need to:
+##### High queue utilization
+
+Monitor the `otelcol_exporter_queue_size` and `otelcol_exporter_queue_capacity` metrics. If the queue is consistently full, you may need to:
 - Reduce data ingestion rate
 - Increase queue capacity
 - Scale horizontally with more collectors
 
-**Data dropping**: Watch for logs containing "Dropping data because sending_queue is full" and monitor failed enqueue metrics:
+##### Data dropping
+
+Watch for logs containing "Dropping data because sending_queue is full" and monitor failed enqueue metrics:
 - `otelcol_exporter_enqueue_failed_spans`
 - `otelcol_exporter_enqueue_failed_metric_points` 
 - `otelcol_exporter_enqueue_failed_log_records`
 
-### Accessing Collector Metrics Directly
+### Accessing collector metrics directly
 
 By default, the collector's internal metrics are available in Prometheus format at `http://localhost:8888/metrics`. You can access them using:
 
 ```bash
 curl http://localhost:8888/metrics
 ```
 
-### Log Levels and Configuration
+### Log levels and configuration
 
 Configure different log levels for troubleshooting:
-- **DEBUG**: Most verbose, includes detailed trace information
-- **INFO**: Standard operational information (default)
-- **WARN**: Warning messages about potential issues
-- **ERROR**: Error conditions that need attention
+- **DEBUG**. Most verbose, includes detailed trace information
+- **INFO**. Standard operational information (default)
+- **WARN**. Warning messages about potential issues
+- **ERROR**. Error conditions that need attention
 
 ## Create monitors for OpenTelemetry Collector Insights app
 

docs/platform-services/automation-service/app-central/integrations/aws-athena.md

@@ -6,8 +6,8 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
 
 <img src={useBaseUrl('/img/platform-services/automation-service/app-central/logos/aws.png')} alt="automox" width="50"/>
 
-***Version: 1.1  
-Updated: Jun 15, 2023***
+***Version: 1.2  
+Updated: July 29, 2025***
 
 Amazon Athena is a cloud-based service that enables you to run SQL queries on data stored in Amazon S3 without the need to set up any infrastructure. It is a serverless, pay-per-query service that makes it easy to analyze large amounts of data.
 
@@ -34,9 +34,11 @@ To [get access key and secret access key](https://docs.aws.amazon.com/athena/lat
 
 import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
 import IntegrationsAuthAWS from '../../../../reuse/integrations-authentication-aws.md';
+import IAMConfiguration from '../../../../reuse/automation-service/aws/iam-configuration.md';
 import AWSRegions from '../../../../reuse/automation-service/aws/region.md';
 import AWSAccesskey from '../../../../reuse/automation-service/aws/access-key.md';
 import AWSSecret from '../../../../reuse/automation-service/aws/secret.md';
+import AWSIAMRole from '../../../../reuse/automation-service/aws/iam-role.md';
 import IntegrationCertificate from '../../../../reuse/automation-service/integration-certificate.md';
 import IntegrationEngine from '../../../../reuse/automation-service/integration-engine.md';
 import IntegrationLabel from '../../../../reuse/automation-service/integration-label.md';
@@ -49,16 +51,41 @@ import IntegrationTimeout from '../../../../reuse/automation-service/integration
 * <AWSRegions/>
 * <AWSAccesskey/>
 * <AWSSecret/>
+* <AWSIAMRole/>
 * <IntegrationTimeout/>
 * <IntegrationCertificate/>
 * <IntegrationEngine/>
 * <IntegrationProxy/>
 
 <img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/misc/aws-athena-configuration.png')} style={{border:'1px solid gray'}} alt="AWS Athena configuration" width="400"/>
 
+For information about Amazon Athena, see [Athena documentation](https://docs.aws.amazon.com/athena/).
+
 <IntegrationsAuthAWS/>
 
-For information about Amazon Athena, see [Athena documentation](https://docs.aws.amazon.com/athena/).
+### AWS IAM role-based access
+
+<IAMConfiguration/>
+
+## Required Permissions
+```
+  athena:StartQueryExecution
+  athena:GetQueryExecution
+  athena:GetQueryResults
+  athena:StopQueryExecution
+  athena:ListDatabases
+  athena:ListWorkGroups
+  athena:ListTableMetadata
+  glue:GetDatabase
+  glue:GetDatabases
+  glue:GetTable
+  glue:GetTables
+  glue:GetTableVersion
+  glue:GetTableVersions
+  s3:GetObject
+  s3:PutObject
+  s3:ListBucket
+```
 
 ## External Libraries
 
@@ -68,3 +95,4 @@ For information about Amazon Athena, see [Athena documentation](https://docs.aws
 
 * February 22, 2023 (v1.0) - First upload
 * June 15, 2023 (v1.1) - Updated the integration with Environmental Variables
+* July 29, 2025 (v1.2) - Added support for IAM role authentication - Users can now authenticate using an AWS IAM Role in addition to access key–based authentication.

docs/platform-services/automation-service/app-central/integrations/aws-cloudfront.md

@@ -6,8 +6,8 @@ import useBaseUrl from '@docusaurus/useBaseUrl';
 
 <img src={useBaseUrl('/img/platform-services/automation-service/app-central/logos/aws.png')} alt="aws" width="50"/>
 
-***Version: 1.3  
-Updated: Jun 15, 2023***
+***Version: 1.4  
+Updated: July 29, 2025***
 
 Amazon CloudFront integrates with AWS Identity and Access Management (IAM), a service that lets your organization do the following:
 
@@ -25,9 +25,11 @@ Amazon CloudFront integrates with AWS Identity and Access Management (IAM), a se
 
 import IntegrationsAuth from '../../../../reuse/integrations-authentication.md';
 import IntegrationsAuthAWS from '../../../../reuse/integrations-authentication-aws.md';
+import IAMConfiguration from '../../../../reuse/automation-service/aws/iam-configuration.md';
 import AWSRegions from '../../../../reuse/automation-service/aws/region.md';
 import AWSAccesskey from '../../../../reuse/automation-service/aws/access-key.md';
 import AWSSecret from '../../../../reuse/automation-service/aws/secret.md';
+import AWSIAMRole from '../../../../reuse/automation-service/aws/iam-role.md';
 import IntegrationCertificate from '../../../../reuse/automation-service/integration-certificate.md';
 import IntegrationEngine from '../../../../reuse/automation-service/integration-engine.md';
 import IntegrationLabel from '../../../../reuse/automation-service/integration-label.md';
@@ -41,20 +43,32 @@ import IntegrationTimeout from '../../../../reuse/automation-service/integration
 * **Service Name**. Enter `AWS CloudFront`.
 * <AWSAccesskey/>
 * <AWSSecret/>
+* <AWSIAMRole/>
 * <IntegrationTimeout/>
 * <IntegrationCertificate/>
 * <IntegrationEngine/>
 * <IntegrationProxy/>
 
 <img src={useBaseUrl('/img/platform-services/automation-service/app-central/integrations/aws/aws-cloudfront-configuration.png')} style={{border:'1px solid gray'}} alt="AWS CloudFront configuration" width="400"/>
 
+For information about AWS CloudFront, see [CloudFront documentation](https://docs.aws.amazon.com/cloudfront/).
+
 <IntegrationsAuthAWS/>
 
-For information about AWS CloudFront, see [CloudFront documentation](https://docs.aws.amazon.com/cloudfront/).
+### AWS IAM role-based access
+
+<IAMConfiguration/>
+
+## Required Permissions
+```
+  cloudfront:ListCloudFrontOriginAccessIdentities
+  cloudfront:GetCloudFrontOriginAccessIdentity
+```
 
 ## Change Log
 
 * November 10, 2022 - First upload
 * April 14, 2023 (v1.1)
 	+ Updated integration: (Updated the integration Fields with Environmental Variables)
 * June 15, 2023 (v1.3) - Updated the integration with Environmental Variables
+* July 29, 2025 (v1.4) - Added support for IAM role authentication - Users can now authenticate using an AWS IAM Role in addition to access key–based authentication.