APM reader user

edit

APM reader users typically need to view the APM app 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

edit

To create an APM reader user:

  1. Create a new role, named something like read-apm, and assign the following privileges:

    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

    Using the APM integration for Elastic Agent? Add the privileges under the Data streams tab.

  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

edit

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:

    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

    Using the APM integration for Elastic Agent? Add the privileges under the Data streams tab.

  2. Assign space privileges to any Kibana space that the user needs access to. Here are two examples:

    Type Privilege Purpose

    Spaces

    Read or All on the APM app

    Allow the use of the the APM app

    Spaces

    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