Fix include_linked_accounts documentation (#35665)

metricbeat/docs/modules/aws.asciidoc

@@ -77,10 +77,16 @@ If endpoint is specified, `regions` config becomes required.
 
 * *include_linked_accounts*
 
-The `include_linked_accounts` parameter is used to enable the inclusion of metrics from different accounts linked to a main monitoring account. By setting this parameter to true, users can gather metrics from multiple AWS accounts that are linked through the https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Cross-Account-Cross-Region.html[Cross-Account Cross-Region feature in Amazon CloudWatch].
-By default, the `include_linked_accounts` parameter is set to false, meaning that only metrics from the main monitoring account are collected. When set to true, the parameter allows the CloudWatch service to access and retrieve metrics from the linked accounts, providing a comprehensive view of metrics across multiple accounts.
-
-*_Note_:* Enabling the include_linked_accounts parameter requires appropriate permissions and authentication credentials for the linked accounts. Users should ensure that the necessary IAM roles and policies are properly set up to establish the necessary trust and access between accounts.
+The `include_linked_accounts` parameter is used to enable the inclusion of metrics from different accounts linked to a
+main monitoring account. By setting this parameter to true, users can gather metrics from multiple AWS accounts that are
+linked through the https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html[CloudWatch cross-account observability].
+By default, the `include_linked_accounts` parameter is set to false, meaning that only metrics from the main monitoring
+account are collected. When set to true, the parameter allows the CloudWatch ListMetrics API to include metrics from
+the monitoring account and all linked accounts in the returned data, providing a comprehensive cross-account view.
+
+*_Note_:* Users should ensure that the necessary IAM roles and policies are properly set up in order to link the monitoring
+account and source accounts together.
+Please see https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account-Setup.html#CloudWatch-Unified-Cross-Account-Setup-permissions[Link monitoring accounts with source accounts] for more details.
 
 * *tags_filter*
 

x-pack/metricbeat/module/aws/_meta/docs.asciidoc

@@ -65,10 +65,16 @@ If endpoint is specified, `regions` config becomes required.
 
 * *include_linked_accounts*
 
-The `include_linked_accounts` parameter is used to enable the inclusion of metrics from different accounts linked to a main monitoring account. By setting this parameter to true, users can gather metrics from multiple AWS accounts that are linked through the https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Cross-Account-Cross-Region.html[Cross-Account Cross-Region feature in Amazon CloudWatch].
-By default, the `include_linked_accounts` parameter is set to false, meaning that only metrics from the main monitoring account are collected. When set to true, the parameter allows the CloudWatch service to access and retrieve metrics from the linked accounts, providing a comprehensive view of metrics across multiple accounts.
-
-*_Note_:* Enabling the include_linked_accounts parameter requires appropriate permissions and authentication credentials for the linked accounts. Users should ensure that the necessary IAM roles and policies are properly set up to establish the necessary trust and access between accounts.
+The `include_linked_accounts` parameter is used to enable the inclusion of metrics from different accounts linked to a
+main monitoring account. By setting this parameter to true, users can gather metrics from multiple AWS accounts that are
+linked through the https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html[CloudWatch cross-account observability].
+By default, the `include_linked_accounts` parameter is set to false, meaning that only metrics from the main monitoring
+account are collected. When set to true, the parameter allows the CloudWatch ListMetrics API to include metrics from
+the monitoring account and all linked accounts in the returned data, providing a comprehensive cross-account view.
+
+*_Note_:* Users should ensure that the necessary IAM roles and policies are properly set up in order to link the monitoring
+account and source accounts together.
+Please see https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account-Setup.html#CloudWatch-Unified-Cross-Account-Setup-permissions[Link monitoring accounts with source accounts] for more details.
 
 * *tags_filter*