Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Daily release/sep 18 2024 6 24 #18706

Merged
merged 16 commits into from
Sep 19, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -180,7 +180,7 @@ These queries apply for some older New Relic organizations that have only two us

### Count of full platform users and basic users

The [](/docs/accounts/accounts-billing/new-relic-one-pricing-users/pricing-billing#billing-usage-ui) shows the count of full platform users and basic users. The query used is:
The [How New Relic pricing works](/docs/accounts/accounts-billing/new-relic-one-pricing-users/pricing-billing#billing-usage-ui) shows the count of full platform users and basic users. The query used is:

```sql
FROM NrUsage SELECT max(usage) SINCE 10 days ago
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -238,7 +238,7 @@ User assets that are migrated include:
* Weekly email settings
* Email opt in/out preferences
* User-specific [user keys](/docs/apis/intro-apis/new-relic-api-keys/#user-api-key)
* New Relic apps [NerdStorage data](https://developer.newrelic.com/explore-docs/nerdstorage)
* New Relic apps [NerdStorage data](/docs/new-relic-solutions/build-nr-ui/nerdstorage)

If a user has access to several organizations that use New Relic (for example, if that user is a contractor), their original user model record won't be fully deleted until all those organizations migrate their users. Such a user will have both an original user record and one or more new user records, and if that's the case, that is displayed upon login (see [the login screenshot in Page 1 section](#page1)).

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -244,7 +244,7 @@ Here are all our available NerdGraph docs:
</td>

<td>
[Build a New Relic app](https://developer.newrelic.com/explore-docs/query-and-store-data)
[Build a New Relic app](/docs/new-relic-solutions/build-nr-ui/query-and-store-data)
</td>
</tr>

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ If you're new to GraphQL, get acquainted with the GraphQL API via the NerdGraph
Let's say that you've built a NerdGraph query you're happy with and you want to test it elsewhere. To capture code-ready queries and mutations:

1. Select the <DNT>**Tools**</DNT> menu.
2. Copy the query as a curl call or as a [New Relic CLI](https://developer.newrelic.com/explore-docs/newrelic-cli) command.
2. Copy the query as a curl call or as a [New Relic CLI](/docs/new-relic-solutions/build-nr-ui/newrelic-cli) command.

<img
title="NerdGraph tools menu"
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -353,24 +353,26 @@ Follow these instructions to set up mutual TLS authentication for etcd in [OpenS

## See your data [#check-integration-works]

If the integration has been been set up correctly, the [Kubernetes cluster explorer](/docs/integrations/kubernetes-integration/cluster-explorer/kubernetes-cluster-explorer) contains all the control plane components and their status in a dedicated section, as shown below.
If the integration is set up correctly, you'll see a view with all the control plane components and their statuses in a dedicated section, as shown below.

<img
title="new-relic-one-k8s-cluster-explorer-control-plane-parameters.png"
alt="New Relic - Kubernetes cluster explorer - Control Plane section"
src="/images/kubernetes_screenshot-full_cluster-explorer-control-plane.webp"
src="/images/kubernetes_screenshot-crop_control-plane.webp"
/>

<figcaption>
<DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Kubernetes Cluster Explorer**</DNT>: Use the Kubernetes cluster explorer to monitor and collect metrics from your cluster's Control Plane components.
Go to <DNT>**[one.newrelic.com > All capabilities](https://one.newrelic.com/all-capabilities) > Kubernetes**</DNT> and click <DNT>**Control plane**</DNT> on the left navigation pane.
</figcaption>

You can also check for control plane data with this [NRQL](/docs/query-data/nrql-new-relic-query-language/getting-started/introduction-nrql) query:

```SQL
SELECT latest(timestamp) FROM K8sApiServerSample, K8sEtcdSample, K8sSchedulerSample, K8sControllerManagerSample FACET entityName where clusterName = '_MY_CLUSTER_NAME_'
```sql
SELECT latest(timestamp)
FROM K8sApiServerSample, K8sEtcdSample, K8sSchedulerSample, K8sControllerManagerSample FACET entityName
WHERE clusterName = '_MY_CLUSTER_NAME_'
```

<Callout variant="tip">
If you still can't see Control Plane data, try the solution described in [Kubernetes integration troubleshooting: Not seeing data](/docs/integrations/kubernetes-integration/troubleshooting/kubernetes-integration-troubleshooting-not-seeing-data).
If you still can't see control plane data, try the solution described in [Kubernetes integration troubleshooting: Not seeing data](/docs/kubernetes-pixie/kubernetes-integration/troubleshooting/kubernetes-integration-troubleshooting-not-seeing-data/).
</Callout>
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ freshnessValidatedDate: never
Each lesson in the course builds upon the last, so make sure you've completed the last lesson, Add chart components to your A/B test application, before starting this one.
</Callout>

In this course, you're building an A/B test application for the New Relic platform. Previously, you learned about the New Relic One SDK and its component library. Now, It's time for you to start building your application focusing first on chart components.
In this course, you're building an A/B test application for the New Relic platform. Previously, you learned about the New Relic One SDK](/docs/new-relic-solutions/build-nr-ui/sdk-component/intro-to-sdk) and its component library. Now, It's time for you to start building your application focusing first on chart components.

There are several charts you need to create, which may seem overwhelming at first, but take it one step at a time. The topmost chart, and the first you'll create, is a line chart that shows the number of users who sign up for your newsletter and what version of your website they were shown.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -206,7 +206,7 @@ const ErrorState = () => (
</Steps>

<Callout variant="tip">
If you receive a `RequestError` for a self-signed certificate when you run `nr1 create`, you may need to add a certificate to Node's certificate chain. Read more about this and other advanced configurations in Enable advanced configurations for your Nerdpack.
If you receive a `RequestError` for a self-signed certificate when you run `nr1 create`, you may need to add a certificate to Node's certificate chain. Read more about this and other advanced configurations in [Enable advanced configurations for your Nerdpack](/docs/new-relic-solutions/new-relic-one/build-nr-apps/advanced-config).
</Callout>

As a result, you have a new `visualizations/my-awesome-visualization` directory in `my-awesome-nerdpack`:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -120,7 +120,7 @@ The launcher icon that appears on the **Apps** page in New Relic when an applica

Launchers have their own file structure. Note that:

* A launcher is not required; as an alternative to using a launcher, you can associate your application with a monitored entity.
* A launcher is not required; as an alternative to using a launcher, you can [associate your application with a monitored entity](/docs/new-relic-solutions/tutorials/attach-nerdlet-entity).

* An application can have more than one launcher, which might be desired for an application with multiple Nerdlets.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ metaDescription: 'Learn about NerdStorage components'
freshnessValidatedDate: 2024-04-29
---

To help you build a New Relic application, we provide you with the New Relic One SDK. On this page, you'll learn how to use NerdStorage SDK components.
To help you build a New Relic application, we provide you with the New Relic One SDK](/docs/new-relic-solutions/build-nr-ui/sdk-component/intro-to-sdk). On this page, you'll learn how to use NerdStorage SDK components.

## Use NerdStorage in your apps [#nerdstorage]

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -10,39 +10,39 @@ metaDescription: 'Learn about NerdStorageVault usage'
freshnessValidatedDate: 2024-04-29
---

To help you build a New Relic application, we provide you with the New Relic One SDK. On this page, you'll learn how to use NerdStorageVault to store data in an encrypted storage solution.
To help you build a New Relic application, we provide you with the [New Relic One SDK](/docs/new-relic-solutions/build-nr-ui/sdk-component/intro-to-sdk). On this page, you'll learn how to use `NerdStorageVault` to store data in an encrypted storage solution.

## Using NerdStorageVault in your apps [#using]
## Using `NerdStorageVault` in your apps [#using]

Use NerdStorageVault to store and retrieve sensitive secrets data such as:
Use `NerdStorageVault` to store and retrieve sensitive secrets data such as:

* personal access tokens
* license keys
* API keys
* other third party secrets

<Callout variant="tip">
NerdStorageVault is encrypted with AES-256 encryption.
`NerdStorageVault` is encrypted with AES-256 encryption.
</Callout>

## Usage considerations [#usage]

* This storage is unique per Nerdpack, and can't be shared with any other Nerdpack.
* NerdStorageVault can currently only be used within the context of a Nerdpack.
* You cannot make a direct query or mutation to NerdStorageVault.
* `NerdStorageVault` can currently only be used within the context of a Nerdpack.
* You cannot make a direct query or mutation to `NerdStorageVault`.
* You can explore the fields and response types via the [NerdGraph API explorer](https://api.newrelic.com/graphiql).
* The only supported scope is ACTOR, or data that relates to a particular user.

## Component library [#component]

Currently NerdStorageVault is available in the alpha release of [Nr1 Community component library](https://www.npmjs.com/package/@newrelic/nr1-community/v/1.3.0-alpha.5) and is not available in the Nr1 core components library. Open source components can be use to augment Nr1 core components for additional functionality.
Currently `NerdStorageVault` is available in the alpha release of [Nr1 Community component library](https://www.npmjs.com/package/@newrelic/nr1-community/v/1.3.0-alpha.5) and is not available in the Nr1 core components library. Open source components can be use to augment Nr1 core components for additional functionality.

## NerdGraph queries [#nerdgraph]

Below are examples of the queries used by the components to interact with NerdStorageVault.
Below are examples of the queries used by the components to interact with `NerdStorageVault`.

<Callout variant="tip">
NerdStorageVault can currently only be used within the context of a Nerdpack.
`NerdStorageVault` can currently only be used within the context of a Nerdpack.
</Callout>

### Write [#write]
Expand Down Expand Up @@ -115,7 +115,7 @@ query {
* A secret value is limited to 5000 characters.
* A key value is limited to 64 characters.

### Permissions for working with NerdStorageVault [#permissions]
### Permissions for working with `NerdStorageVault` [#permissions]

In order to persist changes to NerdStorageVault, such as writing, deleting,
In order to persist changes to `NerdStorageVault`, such as writing, deleting,
and fetching data, you must have a [user role with permission to persist changes](/docs/accounts/original-accounts-billing/original-users-roles/users-roles-original-user-model).
Original file line number Diff line number Diff line change
Expand Up @@ -136,7 +136,7 @@ By default, the command displays the autocomplete instructions for `zsh`. If you

Creates a new component from our template, either a Nerdpack, Nerdlet, launcher, or catalog. The CLI will walk you through this process.

To learn more about Nerdpacks and their file structure, see [Nerdpack file structure](/explore-docs/nerdpack-file-structure). For more on how to set up your Nerdpacks, see our [Nerdpack CLI commands](/explore-docs/nr1-nerdpack).
To learn more about Nerdpacks and their file structure, see [Nerdpack file structure](/docs/new-relic-solutions/build-nr-ui/nerdpack-file-structure). For more on how to set up your Nerdpacks, see our [Nerdpack CLI commands](/docs/new-relic-solutions/build-nr-ui/nr1-cli/nr1-nerdpack).

### Usage

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ metaDescription: 'Reference for query components using NerdGraph'
freshnessValidatedDate: 2024-04-29
---

To help you build a New Relic application, we provide you with the New Relic One SDK. Here you can learn how to use the SDK query components, which allow you to make queries and mutations via [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph/), our GraphQL endpoint.
To help you build a [New Relic application](/docs/new-relic-solutions/tutorials/build-hello-world-app), we provide you with the [New Relic One SDK](/docs/new-relic-solutions/build-nr-ui/sdk-component/intro-to-sdk). Here you can learn how to use the SDK query components, which allow you to make queries and mutations via [NerdGraph](/docs/apis/nerdgraph/get-started/introduction-new-relic-nerdgraph/), our GraphQL endpoint.

<Callout variant="tip">
Query-related React components can be identified by the `Query` suffix. Mutation-related components can be identified by the `Mutation` prefix.
Expand Down Expand Up @@ -87,6 +87,6 @@ Similarly, a mutation can happen either way; either declaratively or imperativel

* `NERD_GRAPH`: Returns the format in which it arrives from NerdGraph.
* `RAW`: The format exposed by default in Insights and dashboards when being plotted as JSON. This format is useful if you have a pre-existing script in this format that you're willing to migrate to or incorporate with.
* `CHART`: The format used by the charting engine that we also expose.
* `CHART`: The format used by the charting engine that we also expose. You can find a more detailed explanation of how to manipulate this format in the [guide to chart components](/docs/new-relic-solutions/build-nr-ui/sdk-component/intro-to-sdk), and some examples.

If you're willing to push data, we currently don't expose `NrqlMutation`. To do that, see the [Event API](/docs/data-apis/ingest-apis/event-api/introduction-event-api/) for how to add custom events.
Loading
Loading