Skip to content

Commit a80e561

Browse files
sujitnewrelicsujitnewrelic
committed
Update dlanguage review comments and separated access management procedure.
1 parent b21c625 commit a80e561

File tree

4 files changed

+53
-80
lines changed

4 files changed

+53
-80
lines changed

‎src/content/docs/data-apis/ingest-apis/metric-api/cardinality-access-management.mdx

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
---
2+
title: 'Access management for managing cardinality'
3+
metaDescription: 'As a New Relic Authentication Domain Manager, learn how to manage cardinality related access for users.'
4+
freshnessValidatedDate: never
5+
---
6+
7+
As an Authentication Domain Manager, perform the following steps to grant access to a user for managing account and metrics cardinality. Check with the user about their specific needs and accordingly do the configuration. To learn more about user management, refer to [User management tutorial](/docs/accounts/accounts-billing/new-relic-one-user-management/account-user-mgmt-tutorial/).
8+
9+
<Steps>
10+
11+
<Step>
12+
### Add permissions to a custom role [#permissions-to-custom-role]
13+
[Create a new custom role](/docs/accounts/accounts-billing/new-relic-one-user-management/account-user-mgmt-tutorial/#roles) with the following permissions, or add them to an existing role. Check with the user to understand the level of access required.
14+
* `Manage account cardinality`: Adjust the cardinality budget of the account.
15+
* `View`: Can see the cardinality budget of the account.
16+
* `Modify`: Can update the cardinality budget of the account.
17+
* `Manage metric cardinality`: Adjust the cardinality budget of metrics.
18+
* `View`: Can see the cardinality budget of the metrics.
19+
* `Modify`: Can update the cardinality budget of the metrics.
20+
* `Manage pruning rules`: Manage pruning rules for metrics.
21+
* `View`: Can see the pruning rules of the metrics.
22+
* `Modify`: Can create and delete pruning rules for the metrics.
23+
</Step>
24+
25+
<Step>
26+
### Add user, role, and account to a group [#group-access]
27+
For the cardinality management, [create a new group](/docs/accounts/accounts-billing/new-relic-one-user-management/account-user-mgmt-tutorial/#group-access) or manage an existing group as follows:
28+
1. Navigate to **[New Relic Administration](https://one.newrelic.com/admin-portal) > Access Management > Groups**.
29+
2. Click <DNT>**Create a new group**</DNT>, or select <DNT>**Manage group access**</DNT> from the <Icon name="fe-more-horizontal"/> menu of an existing group.
30+
3. For a new group, provide a name and click <DNT>**Create group**</DNT>. The <DNT>**Admin**</DNT> pane for the group opens.
31+
4. Under <DNT>**Members**</DNT>, add the user.
32+
5. Under <DNT>**Account access**</DNT>, associate the custom role with the desired account for cardinality management.
33+
6. If cardinality management involves multiple accounts, under <DNT>**Account access**</DNT>, include the custom role for each relevant account within the group.
34+
</Step>
35+
36+
</Steps>
37+
38+
39+
## Related topics [#related-topics]
40+
41+
<DocTiles>
42+
<DocTile title="Manage cardinality" path="/docs/data-apis/ingest-apis/metric-api/cardinality-management" >Learn how to maintain cardinality within its budget, and when needed how to adjust it.</DocTile>
43+
<DocTile title="Monitor cardinality" path="/docs/data-apis/ingest-apis/metric-api/monitor-cardinality" >Learn how to monitor cardinality usage.</DocTile>
44+
<DocTile title="Understand and query high cardinality metrics" path="/docs/data-apis/ingest-apis/metric-api/NRQL-high-cardinality-metrics" >Understand the concept of cardinality and learn how to query and analyze high cardinality metrics using NRQL.</DocTile>
45+
</DocTiles>

‎src/content/docs/data-apis/ingest-apis/metric-api/cardinality-management.mdx

Lines changed: 5 additions & 80 deletions
Original file line numberDiff line numberDiff line change
@@ -13,78 +13,29 @@ New relic provides a budget of 15 million cardinality per account per day. Under
1313

1414
To manage cardinality or create pruning rules, you need specific permissions. Reach out to your Authentication Domain Manager with your requirements.
1515

16-
<CollapserGroup>
17-
<Collapser id="access-management" title="Access management (By Authentication Domain Manager)">
18-
19-
As an Authentication Domain Manager, perform the following steps to grant access to a user for managing account and metrics cardinality. Check with the user about their specific needs and accordingly do the configuration. To learn more about user management, refer to [User management tutorial](/docs/accounts/accounts-billing/new-relic-one-user-management/account-user-mgmt-tutorial/).
20-
21-
<Steps>
22-
23-
<Step>
24-
### Add permissions to a custom role [#permissions-to-custom-role]
25-
[Create a new custom role](/docs/accounts/accounts-billing/new-relic-one-user-management/account-user-mgmt-tutorial/#roles) with the following permissions, or add them to an existing role. Check with the user to understand the level of access required.
26-
* `Manage account cardinality`: Adjust the cardinality budget of the account.
27-
* `View`: Can see the cardinality budget of the account.
28-
* `Modify`: Can update the cardinality budget of the account.
29-
* `Manage metric cardinality`: Adjust the cardinality budget of metrics.
30-
* `View`: Can see the cardinality budget of the metrics.
31-
* `Modify`: Can update the cardinality budget of the metrics.
32-
* `Manage pruning rules`: Manage pruning rules for metrics.
33-
* `View`: Can see the pruning rules of the metrics.
34-
* `Modify`: Can create and delete pruning rules for the metrics.
35-
</Step>
36-
37-
<Step>
38-
### Add user, role, and account to a group [#group-access]
39-
For the cardinality management, [create a new group](/docs/accounts/accounts-billing/new-relic-one-user-management/account-user-mgmt-tutorial/#group-access) or manage an existing group as follows:
40-
1. Navigate to **[New Relic Administration](https://one.newrelic.com/admin-portal) > Access Management > Groups**.
41-
2. Click <DNT>**Create a new group**</DNT>, or select <DNT>**Manage group access**</DNT> from the <Icon name="fe-more-horizontal"/> menu of an existing group.
42-
3. For a new group, provide a name and click <DNT>**Create group**</DNT>. The <DNT>**Admin**</DNT> pane for the group opens.
43-
4. Under <DNT>**Members**</DNT>, add the user.
44-
5. Under <DNT>**Account access**</DNT>, associate the custom role with the desired account for cardinality management.
45-
6. If cardinality management involves multiple accounts, under <DNT>**Account access**</DNT>, include the custom role for each relevant account within the group.
46-
</Step>
47-
48-
</Steps>
49-
</Collapser>
50-
</CollapserGroup>
51-
5216

5317
## Account pruning rules [#account-pruning-rules]
5418

5519
A common method to maintain account cardinality within its budget is to implement pruning rules for non-critical attributes, which removes unnecessary data.
5620

5721
### View account pruning rules [#view-pruning-rules]
5822

59-
<Steps>
60-
61-
<Step>
6223
### Prerequisite [#prerequisites]
6324
To view account pruning rules, you must have the `Manage pruning rules: view` permission. Reach out to your Authentication Domain Manager to [add this permission](#access-management) to your custom role.
64-
</Step>
6525

66-
<Step>
6726
To view account pruning rules:
68-
1. Navigate to to **<DNT>[one.newrelic.com](https://one.newrelic.com)</DNT> > (click your user name) > <DNT>Administration > Cardinality Management</DNT>**.
27+
1. Navigate to **<DNT>[one.newrelic.com](https://one.newrelic.com)</DNT> > (click your user name) > <DNT>Administration > Cardinality Management</DNT>**.
6928
2. From the **Metrics** table, click <DNT>**View Pruning Rules**</DNT>. A scrollable list of all pruning rules associated with the account appears.
7029

7130
<Callout variant="tip">
7231
If no pruning rules exist in the account, the <DNT>**View Pruning Rules**</DNT> button doesn't appear.
7332
</Callout>
74-
</Step>
75-
76-
</Steps>
7733

7834
### Create a pruning rule [#create-pruning-rule]
7935

80-
<Steps>
81-
82-
<Step>
8336
### Prerequisite [#prerequisites]
8437
To create account pruning rules, you must have the `Manage pruning rules: modify` permission. Reach out to your Authentication Domain Manager to [add this permission](#access-management) to your custom role.
85-
</Step>
8638

87-
<Step>
8839
To create account pruning rules:
8940
1. Navigate to to **<DNT>[one.newrelic.com](https://one.newrelic.com)</DNT> > (click your user name) > <DNT>Administration > Cardinality Management</DNT>**.
9041
2. From the **Metrics** table, select the metric in which you want to create a pruning rule. The **Cardinality Management** page of the metric opens.
@@ -107,31 +58,21 @@ A common method to maintain account cardinality within its budget is to implemen
10758

10859
4. Click <DNT>**Submit**</DNT>.
10960

110-
<Callout variant="important">
61+
<Callout variant="caution">
11162
Pruning rules take effect immediately. Ensure you want to prune the data before creating a rule. You can delete a pruning rule after creating it, but the rule may prune some data before you remove it.
11263
</Callout>
113-
</Step>
114-
115-
</Steps>
11664

11765

11866
### Delete a pruning rule [#delete-pruning-rule]
11967

120-
<Steps>
121-
122-
<Step>
12368
### Prerequisite [#prerequisites]
12469
To delete account pruning rules, you must have the `Manage pruning rules: modify` permission. Reach out to your Authentication Domain Manager to [add this permission](#access-management) to your custom role.
125-
</Step>
12670

127-
<Step>
12871
To delete account pruning rules:
12972
1. Navigate to to **<DNT>[one.newrelic.com](https://one.newrelic.com)</DNT> > (click your user name) > <DNT>Administration > Cardinality Management</DNT>**.
13073
2. From the **Metrics** table, select <DNT>**View Pruning Rules**</DNT>.
13174
3. Scroll to the relevant pruning rule and delete it.
132-
</Step>
13375

134-
</Steps>
13576

13677
## Per-metric budget adjustment [#per-metric-limit-adjustment]
13778

@@ -143,39 +84,25 @@ When all attributes of a specific metric are crucial and you approach your cardi
14384

14485
### Edit per-metric budget [#edit-per-metric-limit]
14586

146-
<Steps>
147-
148-
<Step>
14987
### Prerequisite [#prerequisites]
15088
To adjust per-metric budgets, you must have the `Manage metric cardinality: modify` permission. Reach out to your Authentication Domain Manager to [add this permission](#access-management) to your custom role.
151-
</Step>
15289

153-
<Step>
15490
To adjust the per-metric budget:
15591
1. Navigate to to **<DNT>[one.newrelic.com](https://one.newrelic.com)</DNT> > (click your user name) > <DNT>Administration > Cardinality Management</DNT>**.
15692
2. Select the metric for which you want to adjust the budget. The **Cardinality Management** page of the metric opens.
15793
3. Click <DNT>**Adjust metric budget**</DNT>.
15894
4. Update the budget to meet your needs. Make sure, it is less than or equal to 1 million.
159-
</Step>
160-
161-
</Steps>
16295

16396

16497
## Additional account cardinality budget adjustment [#additional-account-cardinality-budget-adjustment]
16598
While the default cardinality budget of 15 million is sufficient for most users, you may require a higher budget to accommodate your data needs. While you set an upper limit, you are only charged for the aggregates you generate above the 15 million default cardinality budget, up to the new limit you've set. Currently you can increase the cardinality budget of your account up to 200 million. If you need a higher budget, [create a support ticket](https://one.newrelic.com/help-xp).
16699

167-
<Steps>
168-
169-
<Step>
170100
### Prerequisites [#prerequisites]
171101
To adjust the cardinality budget of your account, you must have:
172102
* Subscribed to the [Advanced compute add-on](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/add-on-billing).
173-
* The `Manage account cardinality: modify` permission. Reach out to your Authentication Domain Manager to [add this permission](#access-management) to your custom role.
174-
</Step>
103+
* The `Manage account cardinality: modify` permission. Reach out to your Authentication Domain Manager to [add this permission](#access-management) to your custom role.
175104

176-
<Step>
177-
### Adjust account cardinality budget [#adjust-account-cardinality-budget]
178-
Perform the following steps to adjust the cardinality budget of your account. The adjustment may take 15 to 20 minutes to take effect.
105+
To adjust the cardinality budget of your account, perform the following steps. The adjustment may take 15 to 20 minutes to take effect.
179106
1. From the <DNT>**Cardinality Management**</DNT> page, click <DNT>**Manage account cardinality**</DNT>.
180107
2. From the <DNT>**Manage account cardinality limit**</DNT> pop-up:
181108
1. Adjust the slider to set the new cardinality budget for your account. The maximum limit is 200 million.
@@ -191,13 +118,11 @@ While the default cardinality budget of 15 million is sufficient for most users,
191118
<Callout variant="tip">
192119
From the <DNT>**Manage account cardinality limit**</DNT> pop-up, you can view the change history to track when and by which user the account cardinality was adjusted.
193120
</Callout>
194-
</Step>
195-
196-
</Steps>
197121

198122
## Related topics [#related-topics]
199123

200124
<DocTiles>
201125
<DocTile title="Monitor cardinality" path="/docs/data-apis/ingest-apis/metric-api/monitor-cardinality" >Learn how to monitor cardinality usage.</DocTile>
202126
<DocTile title="Understand and query high cardinality metrics" path="/docs/data-apis/ingest-apis/metric-api/NRQL-high-cardinality-metrics" >Understand the concept of cardinality and learn how to query and analyze high cardinality metrics using NRQL.</DocTile>
127+
<DocTile title="Access management" path="/docs/data-apis/ingest-apis/metric-api/cardinality-access-management" >As a Authentication Domain Manager, learn how to manage cardinality related access for users.</DocTile>
203128
</DocTiles>

‎src/content/docs/data-apis/ingest-apis/metric-api/monitor-cardinality.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -78,5 +78,6 @@ The <DNT>**Attributes**</DNT> table has the list of top 20 attributes that major
7878
<DocTiles>
7979
<DocTile title="Manage cardinality" path="/docs/data-apis/ingest-apis/metric-api/cardinality-management" >Learn how to maintain cardinality within its budget, and when needed how to adjust it.</DocTile>
8080
<DocTile title="Understand and query high cardinality metrics" path="/docs/data-apis/ingest-apis/metric-api/NRQL-high-cardinality-metrics" >Understand the concept of cardinality and learn how to query and analyze high cardinality metrics using NRQL.</DocTile>
81+
<DocTile title="Access management" path="/docs/data-apis/ingest-apis/metric-api/cardinality-access-management" >As a Authentication Domain Manager, learn how to manage cardinality related access for users.</DocTile>
8182
</DocTiles>
8283

‎src/nav/telemetry-data-platform.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,8 @@ pages:
9696
path: /docs/data-apis/ingest-apis/metric-api/cardinality-management
9797
- title: Understand and query high cardinality metrics
9898
path: /docs/data-apis/ingest-apis/metric-api/NRQL-high-cardinality-metrics
99+
- title: Access management
100+
path: /docs/data-apis/ingest-apis/metric-api/cardinality-access-management
99101
- title: Security data API
100102
path: /docs/data-apis/ingest-apis/security-data-api
101103
- title: Telemetry SDKs

0 commit comments

Comments
 (0)