﻿---
title: APM reader user
description: APM reader users typically need to view the Applications UI and dashboards and visualizations that use APM data. These users might also need to create...
url: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5458/solutions/observability/apm/ui-user-reader
products:
  - APM
  - Elastic Observability
applies_to:
  - Elastic Stack: Generally available
---

# APM reader user
APM reader users typically need to view the Applications UI and dashboards and visualizations that use APM data. These users might also need to create and edit dashboards, visualizations, and machine learning jobs.

## APM reader

To create an APM reader user:
1. Create a new role, named something like `read-apm`, and assign the following privileges:
   <tab-set>
   <tab-item title="Data streams">
   | Type  | Privilege                               | Purpose                                           |
   |-------|-----------------------------------------|---------------------------------------------------|
   | Index | `read` on `logs-apm*`                   | Read-only access to `logs-apm*` data              |
   | Index | `view_index_metadata` on `logs-apm*`    | Read-only access to `logs-apm*` index metadata    |
   | Index | `read` on `metrics-apm*`                | Read-only access to `metrics-apm*` data           |
   | Index | `view_index_metadata` on `metrics-apm*` | Read-only access to `metrics-apm*` index metadata |
   | Index | `read` on `traces-apm*`                 | Read-only access to `traces-apm*` data            |
   | Index | `view_index_metadata` on `traces-apm*`  | Read-only access to `traces-apm*` index metadata  |
   </tab-item>

   <tab-item title="Classic APM indices">
   | Type  | Privilege                        | Purpose                                    |
   |-------|----------------------------------|--------------------------------------------|
   | Index | `read` on `apm-*`                | Read-only access to `apm-*` data           |
   | Index | `view_index_metadata` on `apm-*` | Read-only access to `apm-*` index metadata |
   </tab-item>
   </tab-set>
2. Assign the `read-apm` role created in the previous step, and the following built-in roles to any APM reader users:
   | Role                     | Purpose                                                                          |
   |--------------------------|----------------------------------------------------------------------------------|
   | `kibana_admin`           | Grants access to all features in Kibana.                                         |
   | `machine_learning_admin` | Grants the privileges required to create, update, and view machine learning jobs |


## Partial APM reader

In some instances, you may wish to restrict certain Kibana apps that a user has access to.
1. Create a new role, named something like `read-apm-partial`, and assign the following privileges:
   <tab-set>
   <tab-item title="Data streams">
   | Type  | Privilege                               | Purpose                                           |
   |-------|-----------------------------------------|---------------------------------------------------|
   | Index | `read` on `logs-apm*`                   | Read-only access to `logs-apm*` data              |
   | Index | `view_index_metadata` on `logs-apm*`    | Read-only access to `logs-apm*` index metadata    |
   | Index | `read` on `metrics-apm*`                | Read-only access to `metrics-apm*` data           |
   | Index | `view_index_metadata` on `metrics-apm*` | Read-only access to `metrics-apm*` index metadata |
   | Index | `read` on `traces-apm*`                 | Read-only access to `traces-apm*` data            |
   | Index | `view_index_metadata` on `traces-apm*`  | Read-only access to `traces-apm*` index metadata  |
   </tab-item>

   <tab-item title="Classic APM indices">
   | Type  | Privilege                        | Purpose                                    |
   |-------|----------------------------------|--------------------------------------------|
   | Index | `read` on `apm-*`                | Read-only access to `apm-*` data           |
   | Index | `view_index_metadata` on `apm-*` | Read-only access to `apm-*` index metadata |
   </tab-item>
   </tab-set>
2. Assign feature privileges to any Kibana feature that the user needs access to. Here are two examples:
   | Type   | Privilege                                              | Purpose                                                                      |
   |--------|--------------------------------------------------------|------------------------------------------------------------------------------|
   | Kibana | `Read` or `All` on the APM and User Experience feature | Allow the use of the the Applications and User Experience UIs                |
   | Kibana | `Read` or `All` on Dashboards and Discover             | Allow the user to view, edit, and create dashboards, as well as browse data. |
3. Finally, assign the following role if a user needs to enable and edit machine learning features:
   | Role                     | Purpose                                                                          |
   |--------------------------|----------------------------------------------------------------------------------|
   | `machine_learning_admin` | Grants the privileges required to create, update, and view machine learning jobs |