diff --git a/src/content/docs/new-relic-solutions/observability-maturity/operational-efficiency/dg-intro.mdx b/src/content/docs/new-relic-solutions/observability-maturity/operational-efficiency/dg-intro.mdx index 7bde9875e14..a7a337feca8 100644 --- a/src/content/docs/new-relic-solutions/observability-maturity/operational-efficiency/dg-intro.mdx +++ b/src/content/docs/new-relic-solutions/observability-maturity/operational-efficiency/dg-intro.mdx @@ -2,7 +2,7 @@ title: Data Ingest Governance tags: - Observability maturity - - Operational efficiency + - Operational efficiency - Data ingest governance - Sampling rate - Drop rules @@ -10,7 +10,7 @@ tags: - Value drivers - Bill and Usage Data - Data ingest cost -metaDescription: Data ingest governance is the practice of ensuring optimal value for telemetry data collected. +metaDescription: Data ingest governance is the practice of ensuring optimal value for telemetry data collected. redirects: - /docs/telemetry-data-platform/manage-data/data-governance - /docs/data-governance @@ -31,8 +31,8 @@ import forecastingicon from './images/oma-oe-dg-forecasting-icon.png' Data ingest governance is the practice of ensuring optimal value for telemetry data collected. This practice is especially important to complex organizations with numerous business units and working groups. This guide is for readers who need granularity that goes beyond the [data management views](/docs/data-apis/manage-data/manage-your-data/) in New Relic One. ## Desired outcome [#desired-outcome] - -Ensure a high return on investment in telemetry data. + +Ensure a high return on investment in telemetry data. -Reduce redundant or unnecessary data with confidence. - +Reduce redundant or unnecessary data with confidence. + Understand exactly which groups within the org are contributing which data. Expose where your telemetry data is coming from and reduce data management silos. + -Account for ingest costs in a clear and concise way. Adjust your ingest volume with full context of the observability value of the data. +Account for ingest costs in a clear and concise way. Adjust your ingest volume with full context of the observability value of the data. diff --git a/src/content/docs/serverless-function-monitoring/aws-lambda-monitoring/opentelemetry/lambda-opentelemetry-dotnet.mdx b/src/content/docs/serverless-function-monitoring/aws-lambda-monitoring/opentelemetry/lambda-opentelemetry-dotnet.mdx index 97f085ee1dd..5c69afcfb41 100644 --- a/src/content/docs/serverless-function-monitoring/aws-lambda-monitoring/opentelemetry/lambda-opentelemetry-dotnet.mdx +++ b/src/content/docs/serverless-function-monitoring/aws-lambda-monitoring/opentelemetry/lambda-opentelemetry-dotnet.mdx @@ -29,7 +29,7 @@ To enable X-Ray: 3. Choose **Edit**. 4. Under **X-Ray**, enable **Active tracing**. -Alternatively, if you're using [SAM (Serverless Application Model)](https://aws.amazon.com/serverless/sam/) or [CloudFormation](https://aws.amazon.com/cloudformation/resources/templates/) templates, you can specify this layer by adding the following to your Lambda function's properties: +Alternatively, if you're using [SAM (Serverless Application Model)](https://aws.amazon.com/serverless/sam/) or [CloudFormation](https://aws.amazon.com/cloudformation/resources/templates/) templates, you can enable X-Ray by adding the following to your Lambda function's properties: ```yaml yourFunctionHere: @@ -64,7 +64,7 @@ To install it: 4. Choose **Add**. -For SAM and CloudFormation templates, add the following to your function's properties. Be sure to replace `your-license-key-here` with your [New Relic license key](/docs/apis/intro-apis/new-relic-api-keys/#ingest-keys), and `otlp.nr-data.net:4317` with the New Relic OpenTelemetry endpoint for your region. +For SAM and CloudFormation templates, add the following to your function's properties. Be sure to replace `your-license-key-here` with your [New Relic license key](/docs/apis/intro-apis/new-relic-api-keys/#ingest-keys) and `otlp.nr-data.net:4317` with the New Relic OpenTelemetry Endpoint for your region. ```yaml yourFunctionHere: diff --git a/src/content/docs/serverless-function-monitoring/aws-lambda-monitoring/opentelemetry/lambda-opentelemetry-java.mdx b/src/content/docs/serverless-function-monitoring/aws-lambda-monitoring/opentelemetry/lambda-opentelemetry-java.mdx index 5e4a49f8e0d..47d2567c38f 100644 --- a/src/content/docs/serverless-function-monitoring/aws-lambda-monitoring/opentelemetry/lambda-opentelemetry-java.mdx +++ b/src/content/docs/serverless-function-monitoring/aws-lambda-monitoring/opentelemetry/lambda-opentelemetry-java.mdx @@ -28,7 +28,7 @@ To enable X-Ray: 3. Choose **Edit**. 4. Under **X-Ray**, enable **Active tracing**. -Alternatively, if you're using [SAM (Serverless Application Model)](https://aws.amazon.com/serverless/sam/) or [CloudFormation](https://aws.amazon.com/cloudformation/resources/templates/) templates, you can specify this layer by adding the following to your Lambda function's properties: +Alternatively, if you're using [SAM (Serverless Application Model)](https://aws.amazon.com/serverless/sam/) or [CloudFormation](https://aws.amazon.com/cloudformation/resources/templates/) templates, you can enable X-Ray by adding the following to your Lambda function's properties: ```yaml yourFunctionHere: diff --git a/src/content/docs/style-guide/writing-strategies/install-docs-guidance.mdx b/src/content/docs/style-guide/writing-strategies/install-docs-guidance.mdx new file mode 100644 index 00000000000..5af21d5cb43 --- /dev/null +++ b/src/content/docs/style-guide/writing-strategies/install-docs-guidance.mdx @@ -0,0 +1,96 @@ +--- +title: Choose from our install methods +topics: + - New Relic only + - Basic style guide + - Writing guidelines +--- + +Installing New Relic is a crucial piece in our customer's experience, whether it's installing APM agents, the infrastructure agent, sending logs to New Relic, or installing CodeStream, among other things. + +This is intended to help you decide where to send your reader when they want to install something and get started sending data to New Relic. + +## Choose the best install method [#choose] + + + + + + + + + + + + + + + + +
+ [Guided install](/docs/new-relic-one/install-configure/new-relic-guided-install-overview/) + + [Add more data](https://one.newrelic.com/nr1-core?state=cab9400b-31f1-fab7-cd28-db21bd312951) + + Manual install +
+ * Infrastructure agent + * Logs + * APM agents (except C SDK, Go, PHP, and Ruby) + * One or more of these [on-host integrations](/docs/new-relic-one/install-configure/new-relic-guided-install-overview/#ohi-recipes) + + * APM agents (especially C SDK, Go, PHP, and Ruby) + * Browser monitoring + * Cloud and on-host monitoring integrations + * Distributed tracing + * Infrastructure agent + * Logs + * Machine learning monitoring + * Network performance monitoring + * Open telemetry + * Synthetics monitoring + + Anything not covered by guided install and add more data. +
+ +## An overview of installation methods [#overview] + +Currently, we have three methods our customers can use to install New Relic and start monitoring something: + +1. Guided install, our interactive command line tool for installing New Relic on different systems +2. Manual installation via the “+ Add more data” page in the UI +3. Manual installation via the docs site + +Instant observability (I/O) is **not** an installation method. It simply provides a catalog of all of the things that someone could potentially monitor via New Relic. An instant observability page simply points to one of these three methods, depending on what's available. + +CodeStream has its own installation method. + +## Guided install [#guided] + +[Guided install](/docs/new-relic-one/install-configure/new-relic-guided-install-overview/) provides a single command you can run on your system to install New Relic and start monitoring a variety of things. + +At present, guided install installs the infrastructure agent, configures a certain set of integrations, and enables sending logs. It also detects integrations on your system and prompts you to choose whether to monitor those integrations or not. + +For the docs, we should send people to guided install whenever it's appropriate to do so. That is, when guided install is likely to lead to a successful outcome. + +## Manual installation via add more data [#manual-add] + +The [Add more data](https://one.newrelic.com/nr1-core?state=cab9400b-31f1-fab7-cd28-db21bd312951) pages provide a simple and straightforward installation path for people wanting to install APM agents and who are using the most popular integrations and most common system settings for those integrations. + +**Add more data** populates installation configuration files with values like app name and API key so that a customer doesn't have to track down that information. They also provide the most straightforward installation path for standard use cases. + +This method is less effective for customers who have more complicated or obscure things they're trying to monitor or non-standard systems. + +**Add more data** also has the advantage of living in the UI. + +## Manual installation via the docs site [#manual-docs] + +Manual installation procedures, such as this [manual Java installation](/docs/apm/agents/java-agent/installation/install-java-agent), should be the method of last resort. The installation instructions on the docs site are most likely to be outdated. They are also presented in a fairly confusing way that may actually prevent people from installing New Relic. From the docs perspective, this is the default, because that's where our energy and attention are focused. It's also the place where we can easily make changes. + +That being said, the current state of the manual installation docs is inconsistent and, in some cases, like the APM agent docs, bewilderingly complicated. + +## Instant observability [#io] + +[Instant observability](https://newrelic.com/instant-observability) is catalog of things that can be monitored by New Relic and useful default dashboards and alerts. + +For any quickstart, the **Install quickstart** button takes you to guided install, an add more data page, or a manual installation docs page. diff --git a/src/nav/style-guide.yml b/src/nav/style-guide.yml index 24588c13621..82f1cd1cfef 100644 --- a/src/nav/style-guide.yml +++ b/src/nav/style-guide.yml @@ -13,6 +13,8 @@ pages: path: /docs/style-guide/writing-strategies/organize-doc - title: How to write introductions path: /docs/style-guide/writing-strategies/how-to-write-intros + - title: Choose from our install options + path: /docs/style-guide/writing-strategies/install-docs-guidance - title: Capitalization pages: - title: Capitalization