Merge pull request #18722 from newrelic/infra-docs

Updating intro to AWS doc
newrelic · Sep 23, 2024 · c2d79b1 · c2d79b1
2 parents 850939d + 9ad81b3
commit c2d79b1
Show file tree

Hide file tree

Showing 31 changed files with 152 additions and 77,870 deletions.
diff --git a/...tions/connect/aws-metric-stream-setup.mdx → ...etric-streams/aws-metric-stream-setup.mdx b/...tions/connect/aws-metric-stream-setup.mdx → ...etric-streams/aws-metric-stream-setup.mdx
@@ -5,6 +5,8 @@ tags:
   - Amazon integrations
   - AWS integrations list
 metaDescription: Learn how to gather all AWS metrics and custom namespaces to send them to New Relic.
+redirects:
+    - /docs/infrastructure/amazon-integrations/connect/aws-metric-stream-setup
 freshnessValidatedDate: never
 ---
 

diff --git a/...ntegrations/connect/aws-metric-stream.mdx → ...atch-metric-streams/aws-metric-stream.mdx b/...ntegrations/connect/aws-metric-stream.mdx → ...atch-metric-streams/aws-metric-stream.mdx
@@ -7,8 +7,9 @@ tags:
 translate:
   - jp
 redirects:
-  - /docs/integrations/amazon-integrations/aws-integrations-list/aws-metric-stream
-  - /docs/infrastructure/amazon-integrations/aws-integrations-list/aws-metric-stream
+    - /docs/integrations/amazon-integrations/aws-integrations-list/aws-metric-stream
+    - /docs/infrastructure/amazon-integrations/aws-integrations-list/aws-metric-stream
+    - /docs/infrastructure/amazon-integrations/connect/aws-metric-stream
 metaDescription: Use AWS CloudWatch Metric Streams integration to monitor all CloudWatch metrics from all AWS services.
 freshnessValidatedDate: never
 ---

diff --git a/...s/infrastructure/amazon-integrations/connect/connect-aws-govcloud-new-relic.mdx b/...s/infrastructure/amazon-integrations/connect/connect-aws-govcloud-new-relic.mdx
@@ -1,5 +1,5 @@
 ---
-title: Connect AWS GovCloud to New Relic
+title: Connect AWS GovCloud
 tags:
   - Integrations
   - Amazon integrations

diff --git a/src/content/docs/infrastructure/amazon-integrations/connect/ec2-quickstart.mdx b/src/content/docs/infrastructure/amazon-integrations/connect/ec2-quickstart.mdx
@@ -1,5 +1,5 @@
 ---
-title: Automated monitoring of EC2 instances
+title: Install infrastructure agent on EC2 instances
 tags:
   - Infrastructure
   - Automated monitoring of EC2 instances

diff --git a/src/content/docs/infrastructure/amazon-integrations/connect/eks-add-on.mdx b/src/content/docs/infrastructure/amazon-integrations/connect/eks-add-on.mdx
@@ -9,7 +9,7 @@ metaDescription: New Relic's EKS add-on for EKS monitoring.
 freshnessValidatedDate: never
 ---
 
-Amazon Elastic Kubernetes Service (Amazon EKS) is a managed Kubernetes service that makes it easy for you to run Kubernetes both on AWS and on-premises. Kubernetes is an open-source system for automating deployment, scaling, and management of containerized applications. This document walks you through the steps required to use the EKS addon from AWS Marketplace.
+Amazon Elastic Kubernetes Service (Amazon EKS) is a managed Kubernetes service that makes it easy for you to run Kubernetes both on AWS and on-premises. Kubernetes is an open-source system for automating deployment, scaling, and management of containerized applications. This document walks you through the steps required to use the EKS add-on from AWS Marketplace.
 
 ## Prerequisites [#prereq]
 

diff --git a/...nfrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx b/...nfrastructure/amazon-integrations/get-started/integrations-managed-policies.mdx
@@ -1,5 +1,5 @@
 ---
-title: Integrations and managed policies
+title: Grant New Relic permissions with AWS managed policies
 tags:
   - Integrations
   - Amazon integrations

diff --git a/...nfrastructure/amazon-integrations/get-started/introduction-aws-integrations.mdx b/...nfrastructure/amazon-integrations/get-started/introduction-aws-integrations.mdx
@@ -8,61 +8,127 @@ translate:
   - jp
 metaDescription: Amazon integrations let you monitor your AWS data in several New Relic features.
 redirects:
-  - /docs/integrations/amazon-integrations/get-started/introduction-aws-integrations
-  - /docs/infrastructure/amazon-integrations/getting-started/introduction-aws-integrations
-  - /docs/integrations/amazon-integrations/getting-started/introduction-aws-integrations
-  - /docs/accounts/install-new-relic/partner-based-installation/new-relic-aws-amazon-web-services
-  - /docs/partnerships/amazon-web-services-users
-  - /docs/accounts-partnerships/partnerships/partner-based-installation/amazon-web-services-aws-users
-  - /docs/accounts/install-new-relic/partner-based-installation/amazon-web-services-aws-users
-  - /docs/infrastructure/amazon-integrations/aws-integrations-list/aws-cloudformation-integration
-  - /docs/integrations/amazon-integrations/aws-integrations-list/aws-cloudformation-integration
-  - /docs/aws-cloudformation-integration
-  - /docs/infrastructure/amazon-integrations
-  - /docs/integrations/amazon-integrations
-freshnessValidatedDate: never
+    - /docs/integrations/amazon-integrations/get-started/introduction-aws-integrations
+    - /docs/infrastructure/amazon-integrations/getting-started/introduction-aws-integrations
+    - /docs/integrations/amazon-integrations/getting-started/introduction-aws-integrations
+    - /docs/accounts/install-new-relic/partner-based-installation/new-relic-aws-amazon-web-services
+    - /docs/partnerships/amazon-web-services-users
+    - /docs/accounts-partnerships/partnerships/partner-based-installation/amazon-web-services-aws-users
+    - /docs/accounts/install-new-relic/partner-based-installation/amazon-web-services-aws-users
+    - /docs/infrastructure/amazon-integrations/aws-integrations-list/aws-cloudformation-integration
+    - /docs/integrations/amazon-integrations/aws-integrations-list/aws-cloudformation-integration
+    - /docs/aws-cloudformation-integration
+    - /docs/infrastructure/amazon-integrations
+    - /docs/integrations/amazon-integrations
+freshnessValidatedDate: 2024-09-20
 ---
 
-Amazon integrations let you monitor your AWS data in several New Relic features. Enabling the [AWS CloudWatch Metric Streams](/docs/integrations/amazon-integrations/aws-integrations-list/aws-metric-stream) integration is the recommended solution to monitor all CloudWatch metrics from all AWS services (including custom namespaces). On top of this, additional integrations are available to get extended visibility on key AWS services beyond the available CloudWatch metrics. For a full reference of the supported metrics, please check the available CloudWatch metrics for each service in the AWS documentation pages.
-
-## Connect AWS and New Relic [#connect]
-
-You can connect to AWS using [Amazon CloudWatch Metric Streams](/docs/infrastructure/amazon-integrations/connect/aws-metric-stream/) or via [polling integration](/docs/infrastructure/amazon-integrations/connect/connect-aws-new-relic-infrastructure-monitoring/).
-
-Additional <DNT>**API Polling**</DNT> integrations can be enabled on top of the AWS CloudWatch metric streams in order to pull data that's not available as CloudWatch metrics. The following integrations are not replaced by the metric streams:
+New Relic offers several methods to collect performance data about your Amazon Web Services (AWS) environment. Once you've connected New Relic with AWS, you get total visibility into AWS telemetry data, letting you closely monitor the health of your AWS stack. 
+
+## Integrate New Relic with your AWS stack [#connect]
+
+To get started, you need to establish a connection between New Relic and your AWS services. Establishing the initial connection integrates New Relic into your AWS stack so you can access additional integrations within the AWS ecosystem. 
+
+Here are options to get started:
+
+<table>
+    <thead>
+        <tr>
+            <th>
+                AWS solution
+            </th>
+            <th>
+                New Relic integration method
+            </th>
+        </tr>
+    </thead>
+    <tbody>
+        <tr>
+            <td>
+                CloudWatch Metric Streams
+            </td>
+            <td>
+                [Set up Cloudwatch Metric Streams integration](/docs/infrastructure/amazon-integrations/connect/cloudwatch-metric-streams/aws-metric-stream-setup) (Recommended)
+            </td>
+        </tr>
+        <tr>
+            <td>
+                Amazon EC2 instances
+            </td>
+            <td>
+                [Install the infrastructure agent with CloudFormation template](/docs/infrastructure/amazon-integrations/connect/ec2-quickstart)
+            </td>
+        </tr>
+        <tr>
+            <td>
+                AWS GovCloud (US)
+            </td>
+            <td>
+                [Connect your Amazon account to New Relic](/docs/infrastructure/amazon-integrations/connect/connect-aws-govcloud-new-relic)
+            </td>
+        </tr>
+        <tr>
+            <td>
+                AWS System Manager Distributor
+            </td>
+            <td>
+                [Install the infrastructure agent on AWS System Manager Distributor](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-sys-dist)
+            </td>
+        </tr>
+        <tr>
+            <td>
+                Amazon Elastic Kubernetes Service (Amazon EKS)
+            </td>
+            <td>
+                [Add New Relic to a custom resource definition (CRD) file](/docs/infrastructure/amazon-integrations/connect/eks-add-on)
+            </td>
+        </tr>
+        <tr>
+            <td>
+                Connect to the AWS Polling API
+            </td>
+            <td>
+                [Create new roles and policies to poll and send metric data to New Relic](/docs/infrastructure/amazon-integrations/connect/connect-aws-new-relic-infrastructure-monitoring)
+            </td>
+        </tr>
+    </tbody>
+</table>
+
+## View your AWS data [#view-aws-data]
+
+Once installed and configured, you can access data from your AWS services directly in the New Relic platform. Go to <DNT>**[one.newrelic.com > All capabilities > Amazon Web Services](https://one.newrelic.com/all-capabilities)**</DNT>. 
+
+* To learn more about exploring your AWS data, check out our doc about [understanding and using data from infrastructure integrations](/docs/infrastructure/infrastructure-integrations/get-started/understand-use-data-infrastructure-integrations). 
+* We also recommend [reviewing our doc specifically about AWS integration metrics](/docs/infrastructure/amazon-integrations/manage-aws-data/aws-integrations-metrics), too. 
+
+## Amazon CloudWatch Metric streams and API polling [#api-polling]
+
+We strongly recommend that you use the [CloudWatch Metric Streams integration](/docs/infrastructure/amazon-integrations/connect/cloudwatch-metric-streams/aws-metric-stream-setup) as it directly connects with the metric streams repository holding your AWS metric data. You may have a stack that requires instrumentation with our [API Polling integrations](/docs/infrastructure/amazon-integrations/connect/connect-aws-new-relic-infrastructure-monitoring/), however. For example, these AWS services aren't currently supported by the CloudWatch Metric Streams integration:
 
 * AWS CloudTrail
 * AWS Health
 * AWS Trusted Advisor
 * AWS X-Ray
-
-Finally, other integrations may require additional configurations in your AWS account:
-
 * [AWS VPC Flow Logs](/docs/infrastructure/amazon-integrations/aws-integrations-list/aws-vpc-flow-logs-monitoring-integration/)
 * [AWS CloudFormation](https://github.com/newrelic/cloudformation-partner-integration)
 
 ## Integrations and AWS costs [#cloudwatch-billing]
 
-Keep in mind the following items:
-
-* AWS CloudWatch metric streams pricing is defined based on the number of metric updates. For up-to-date pricing information check [AWS CloudWatch Pricing](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html).
-* AWS Kinesis Data Firehose is used as the delivery method. For details, see the [AWS Firehose pricing page](https://aws.amazon.com/kinesis/data-firehose/pricing/).
-* AWS Config can be optionally enabled in your AWS account, and used to enrich CloudWatch metrics with resource metadata. With AWS Config, you are charged based on the number of configuration items recorded. See the [AWS Config pricing page](https://aws.amazon.com/config/pricing/) for details.
-* [AWS Resource Groups Tagging API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html) is used to enrich metrics with custom tags defined in the associated AWS resources (applicable to both polling and metric streams).
-* If polling integrations are enabled (instead of metric streams), New Relic uses the Amazon CloudWatch API to obtain metrics from the AWS services you monitor. The number of calls to the CloudWatch API increases as you enable more integrations. Add AWS resources to those integrations, or scale those integrations across more regions. This can cause requests to the CloudWatch API to exceed the <DNT>**1 million free**</DNT> limits granted by AWS and [increase your CloudWatch bill](/docs/infrastructure/amazon-integrations/troubleshooting/cloudwatch-billing-increase).
-* AWS offers enhanced monitoring for some of their services which allows for more metrics, more often. For example, see [RDS enhanced monitoring costs](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.overview.html#USER_Monitoring.OS.cost).
-
-## View your AWS data [#insights]
+This section directs you to relevant AWS docs that explain how our integrations affect your AWS billing. 
 
-Once you finish configuration, data from your AWS services reports directly to New Relic. AWS entities for many services are listed in our [entity explorer](/docs/new-relic-one/use-new-relic-one/ui-data/new-relic-one-entity-explorer). Metrics and events appear in [metrics and events](/docs/query-your-data/explore-query-data/browse-data/introduction-data-explorer/). AWS data is also visible in the infrastructure UI.
+* The [AWS CloudWatch Pricing page](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Metric-Streams.html)defines AWS CloudWatch metric streams pricing based on the number of metric updates.
+* We sometimes use AWS Kinesis Data Firehose as the delivery method from AWS to New Relic, so we recommend reviewing the [AWS Firehose pricing page](https://aws.amazon.com/kinesis/data-firehose/pricing/).
+* When you enable AWS Config to enrich CloudWatch metrics with resource metadata, you're charged based on the number of configuration items recorded. See the [AWS Config pricing page](https://aws.amazon.com/config/pricing/) for details.
+* [AWS Resource Groups Tagging API](https://docs.aws.amazon.com/resourcegroupstagging/latest/APIReference/overview.html) enriches metrics with custom tags defined in the associated AWS resources. This affects both polling and metric streams.
 
-To view your AWS data:
+New Relic uses the Amazon CloudWatch API to obtain metrics from your AWS services when you use the API Polling integration instead of CloudWatch Metric Streams. Some situations may increase the number of calls to the CloudWatch API to exceed the <DNT>**1 million free**</DNT> limits granted by AWS and [increase your CloudWatch bill](/docs/infrastructure/amazon-integrations/troubleshooting/cloudwatch-billing-increase). This may happen when you: 
 
-1. Go to <DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities)**</DNT>.
-2. Search for <DNT>**Amazon Web Services**</DNT> and click the tile.
+* Enable additional integrations through API Polling
+* Add AWS resources to those integrations
+* Scale those integrations across more regions.
 
-You can view and reuse NRQL queries both in the pre-configured <InlinePopover type="dashboards"/> and in the <DNT>**Events explorer**</DNT> dashboards. This allows you to tailor queries to your specific needs.
+AWS offers enhanced monitoring for some of their services that allows for more metrics at a higher frequency. You can check out [RDS enhanced monitoring costs](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Monitoring.OS.overview.html#USER_Monitoring.OS.cost) for more information.
 
-## Region availability [#availability]
+## Region availability [#region-availability]
 
 Most AWS services offer regional endpoints to reduce data latency between cloud resources and applications. New Relic can obtain monitoring data from services and endpoints that are located in all [AWS regions](http://docs.aws.amazon.com/general/latest/gr/rande.html), except China.
diff --git a/.../get-started/aws-integrations-metrics.mdx → ...age-aws-data/aws-integrations-metrics.mdx b/.../get-started/aws-integrations-metrics.mdx → ...age-aws-data/aws-integrations-metrics.mdx
@@ -7,6 +7,7 @@ tags:
 redirects:
   - /docs/integrations/amazon-integrations/get-started/aws-integrations-metrics
   - /docs/aws-metrics
+  - /docs/infrastructure/amazon-integrations/get-started/aws-integrations-metrics
 freshnessValidatedDate: never
 ---
 

diff --git a/...ntegrations/connect/aws-multi-account.mdx → ...ons/manage-aws-data/aws-multi-account.mdx b/...ntegrations/connect/aws-multi-account.mdx → ...ons/manage-aws-data/aws-multi-account.mdx
@@ -1,12 +1,14 @@
 ---
-title: AWS multi-account observability
+title: Collect data from multiple AWS accounts
 type: troubleshooting
 tags:
     - Integrations
     - Amazon integrations
     - AWS multi-account
     - CloudWatch cross-account observability
 metaDescription: 'Learn how to observe multiple AWS accounts under a single account on the New Relic user interface.'
+redirects:
+    - /docs/infrastructure/amazon-integrations/connect/aws-multi-account
 freshnessValidatedDate: 2024-07-22
 ---
 

diff --git a/...ct/polling-intervals-aws-integrations.mdx → ...ta/polling-intervals-aws-integrations.mdx b/...ct/polling-intervals-aws-integrations.mdx → ...ta/polling-intervals-aws-integrations.mdx
@@ -1,17 +1,18 @@
 ---
-title: Polling intervals for AWS integrations
+title: Configure polling intervals
 tags:
-  - Integrations
-  - Amazon integrations
-  - Get started
+    - Integrations
+    - Amazon integrations
+    - Get started
 metaDescription: Understand polling intervals for each of your New Relic AWS integrations.
 redirects:
-  - /docs/integrations/amazon-integrations/get-started/polling-intervals-aws-integrations
-  - /docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-polling-intervals-infrastructure-integrations
-  - /docs/infrastructure/amazon-integrations/aws-integrations-list/aws-polling-intervals-infrastructure-integrations
-  - /docs/infrastructure/amazon-integrations/getting-started/polling-intervals-infrastructure-aws-integrations
-  - /docs/integrations/amazon-integrations/getting-started/polling-intervals-infrastructure-aws-integrations
-  - /docs/infrastructure/amazon-integrations/get-started/polling-intervals-aws-integrations
+    - /docs/integrations/amazon-integrations/get-started/polling-intervals-aws-integrations
+    - /docs/infrastructure/infrastructure-integrations/amazon-integrations/aws-polling-intervals-infrastructure-integrations
+    - /docs/infrastructure/amazon-integrations/aws-integrations-list/aws-polling-intervals-infrastructure-integrations
+    - /docs/infrastructure/amazon-integrations/getting-started/polling-intervals-infrastructure-aws-integrations
+    - /docs/integrations/amazon-integrations/getting-started/polling-intervals-infrastructure-aws-integrations
+    - /docs/infrastructure/amazon-integrations/get-started/polling-intervals-aws-integrations
+    - /docs/infrastructure/amazon-integrations/connect/polling-intervals-aws-integrations
 freshnessValidatedDate: never
 ---