github.com/grafana/pyroscope@v1.18.0/docs/sources/configure-server/about-tenant-ids.md (about)

     1  ---
     2  aliases:
     3    - /docs/phlare/latest/operators-guide/configuring/about-tenant-ids/
     4    - /docs/phlare/latest/configure-server/about-tenant-ids/
     5  description: Learn about tenant ID restrictions.
     6  menuTitle: Tenant IDs
     7  title: Tenant IDs
     8  weight: 200
     9  ---
    10  
    11  # Tenant IDs
    12  
    13  Grafana Pyroscope is a multi-tenant system where tenants can query profiles that include their tenant ID.
    14  Within a Grafana Pyroscope cluster, the tenant ID is the unique identifier of a tenant.
    15  The query takes the tenant ID from the `X-Scope-OrgID` parameter that exists in the HTTP header of each request, for example `X-Scope-OrgID: <TENANT-ID>`.
    16  
    17  To push profiles to Pyroscope for a specific tenant, refer to [Configure the Client](https://grafana.com/docs/pyroscope/<PYROSCOPE_VERSION>/configure-client/).
    18  
    19  > By default, multi-tenancy is disabled, the tenant ID is ignored and all profiles are stored and retrieved with the same tenant (`anonymous`).
    20  >
    21  >To enable multi-tenancy, add the `multitenancy_enabled` parameter to the Grafana Pyroscope configuration file and set it to `true`. Alternatively you can also use command line arguments to enable multi-tenancy, for example `--auth.multitenancy-enabled=true`.
    22  
    23  ## Restrictions
    24  
    25  Tenant IDs can't be longer than 150 bytes or characters in length and can only include the following supported characters:
    26  
    27  - Alphanumeric characters
    28    - `0-9`
    29    - `a-z`
    30    - `A-Z`
    31  - Special characters
    32    - Exclamation point (`!`)
    33    - Hyphen (`-`)
    34    - Underscore (`_`)
    35    - Single period (`.`)
    36    - Asterisk (`*`)
    37    - Single quote (`'`)
    38    - Open parenthesis (`(`)
    39    - Close parenthesis (`)`)
    40  
    41  {{< admonition type="note" >}}
    42  For security reasons, `.` and `..` aren't valid tenant IDs.
    43  All other characters, including slashes and whitespace, aren't supported.
    44  {{< /admonition >}}