Web REST API

The Instana Web REST API allows for retrieval of data such as traces and metrics, as well as configuration, such as service extraction and user management. For detailed information, see our Web REST API docs.

Tokens

In order to use the Web REST API, you need to create an API token and assign permissions to it. There are two ways to create an API token that each require a different permission.

Unit Specific API Tokens

Unit specific API tokens can be configured in the API token management page in Settings → Access Control → API Tokens by assigning varying permissions. In order to create or view API tokens, the user has to have the API Token Configuration permission (assigned through a Instana group). Unit specific tokens can be seen/modified by anyone with the correct permission.

Personal API tokens

Personal tokens can be created Settings → User Settings → Personal API Tokens and only require a name to be set. This token "inherits" the permission of the creating user. If an Instana user has the user management permission, then so does the personal API token of said user. Users need Personal API token permission in order to use this feature.

These tokens can be used when individual accountability and traceability is of importance or when users do not want their own API tokens to be exposed to other users.

Usage Examples