Updating ECS Fargate/EC2 Documentation

[mrethers]

PR Description

Update to the ECS documentation to clarify options for Fargate and EC2 and collect application telemetry including metrics, traces and logs.

Notes to the Reviewer

PR Checklist

• [ x] Documentation added

[CLAassistant]

All committers have signed the CLA.

[clayton-cornell]

First pass with suggestions. I'd like to have another read through once these initial suggestions are reviewed/applied.

[clayton-cornell]

Suggested change

	Metrics are available from various sources including ECS itself, the ECS instances when using EC2, X-Ray and your own application. You can also collect logs and traces from your applications instrumented for Prometheus or OTLP.
	Metrics are available from various sources including ECS itself, the ECS instances when using EC2, X-Ray, and your own application.
	You can also collect logs and traces from your applications instrumented for Prometheus or OTLP.

[clayton-cornell]

Suggested change

	1. [Collecting task and container metrics](#collecting-task-and-container-metrics)
	1. [Collecting application telemetry](#collecting-application-telemetry)
	1. [Collecting EC2 instance metrics](#collecting-ec2-instance-metrics)
	1. [Collecting application logs](#collecting-logs)
	1. [Collect task and container metrics](#collect-task-and-container-metrics)
	1. [Collect application telemetry](#collect-application-telemetry)
	1. [Collect EC2 instance metrics](#collect-ec2-instance-metrics)
	1. [Collect application logs](#collect-logs)

[clayton-cornell]

Suggested change

	## Collecting task and container metrics
	## Collect task and container metrics

We should use bare infinitives, no gerunds... so in plain English... a simple task-based thing vs the "ing" form of the verb.

[clayton-cornell]

Suggested change

	In this configuration, an OTEL collector is added to the task running your application and uses the ECS Metadata Endpoint to gather task and container metrics in your cluster.
	In this configuration, you add an OTEL collector to the task running your application, and it uses the ECS Metadata Endpoint to gather task and container metrics in your cluster.

Making the sentence more active

[clayton-cornell]

It's a bit vague what the choice is here... at least with how the bullet points are worded.

Is it simply this?

• You can use ADOT, the AWS OpenTelemetry collector.
• You can use Alloy as a collector next to the Prometheus ECS collector.

[clayton-cornell]

Suggested change

	## Collecting application telemetry
	## Collect application telemetry

[clayton-cornell]

Suggested change

	To collect metrics and traces emitted by your application, use the OTLP endpoints exposed by the collector side car container regardless of the collector implementation. Just specify `localhost` as the host name, which is default for most instrumentation library and agents.
	To collect metrics and traces emitted by your application, use the OTLP endpoints exposed by the collector side car container regardless of the collector implementation.
	Specify `localhost` as the host name, which is default for most instrumentation library and agents.

[clayton-cornell]

Suggested change

	For prometheus endpoints, add a scrape job to the ADOT or Alloy config, and use `localhost` , service port and endpoint path.
	For Prometheus endpoints, add a scrape job to the ADOT or {{< param "PRODUCT_NAME" >}} configuration, and use `localhost` , service port, and endpoint path.

[clayton-cornell]

Suggested change

	## Collecting Logs
	## Collect Logs

[clayton-cornell]

Suggested change

	The easiest way to collect application logs in ECS is to leverage the [AWS firelens log driver][firelens-doc]. Depending on your use case, you can forward your logs to the collector container in your task using the [FluentBit plugin for OpenTelemetry][fluentbit-otel-plugin] or using the FluentBit Loki plugin. You can also send everything directly to your final destination.
	The easiest way to collect application logs in ECS is to leverage the [AWS firelens log driver][firelens-doc].
	Depending on your use case, you can forward your logs to the collector container in your task using the [FluentBit plugin for OpenTelemetry][fluentbit-otel-plugin] or using the FluentBit Loki plugin.
	You can also send everything directly to your final destination.