> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/administration.md).

# Administration

Tenant-wide settings for users, projects, AI, integrations, catalogs, notifications and scans.

**Administration** holds the settings that apply to your whole tenant. Open it from **Administration** in the side menu. It is visible to tenant admins only.

The settings are listed on the left, in groups. Click a setting to open it, or type in **Search settings...** to find one; the search also matches words inside each setting. Until you pick a setting, the page shows **Select a setting**.

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-665c2408a8bf2def4e1b81e51b27261572cdf62b%2Fadministration-2026-11-04.png?alt=media" alt="The Administration page with the settings list on the left and the Ask AI setting open"><figcaption><p>Administration, with the Ask AI setting open.</p></figcaption></figure>

| Group                                   | Settings                                                                                                   |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------- |
| [Access](#access)                       | Users, SSO settings, Projects                                                                              |
| [AI](#ai)                               | Ask AI                                                                                                     |
| [Integrations](#integrations)           | Jira, Microsoft Teams, ServiceNow, Slack                                                                   |
| [Catalogs](#catalogs)                   | Actian Data Intelligence, Alation, Atlan, Databricks Unity Catalog, Microsoft Fabric OneLake               |
| [Advanced settings](#advanced-settings) | Application settings, Hybrid configuration, Managed identities, Notification settings, Spark configuration |

Some settings only appear when they apply to your environment. For example, catalogs appear when catalogs are enabled, **Hybrid configuration** for hybrid deployments, and **Managed identities** for Azure deployments.

## Access

* **Users** — add users to the tenant with **New user**, and choose the projects and roles they get. Click a user to edit them. See [Authentication and Access Control](https://docs.telm.ai/telmai/authentication-and-access-control.md#managing-users).
* **SSO settings** — set up single sign-on. See [SSO Configuration](https://docs.telm.ai/telmai/authentication-and-access-control/sso-configuration.md).
* **Projects** — projects group assets and decide who can see and change them. Create one with **New project**, or click a project to edit it. See [Projects](https://docs.telm.ai/telmai/connect-to-data/projects.md).

## AI

The **Ask AI** setting shows whether Ask AI is on for the tenant, and how many AI tokens it uses.

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-b29d34b5faa8781fee23d46415eafd0e4481f4ce%2Fadministration-ai-2026-11-04.png?alt=media" alt="The Ask AI setting with its status and the Usage and limits table" width="640"><figcaption><p>The Ask AI setting.</p></figcaption></figure>

* **Status** — **Ask AI is on for this tenant** or **Ask AI is not enabled for this tenant**. When it's on, users can chat with the AI agent on the Ask AI page and through the **Ask AI** button, and incidents show AI summaries. Ask AI is installed and turned on by the owners of the Telmai environment, not from this setting. See [Ask AI](https://docs.telm.ai/telmai/ask-ai.md).
* **Usage and limits** — the tokens used by Ask AI, recommended rules and catalog classification in this tenant. For **Today**, **This week** and **This month**, it shows the tokens used against the limit (or **no limit**), a bar for how much of the limit is used, and when the period resets. Periods close to or over their limit are marked **Near the limit** or **Over the limit**.

Limits are set by the owners of the Telmai environment. If you can change them, click **Edit limits** and choose, for each period:

| Option             | Meaning                                                   |
| ------------------ | --------------------------------------------------------- |
| Deployment default | Use the default limit of the deployment.                  |
| No limit           | No limit for this period.                                 |
| Limit              | A limit you set, in tokens. It must be a positive number. |

Then click **Save limits**. When a limit is reached, AI features show a message saying so until the period resets.

## Integrations

* **Jira** — create Jira issues from incidents, by hand or automatically from monitors. See [Jira Integration](https://docs.telm.ai/telmai/integrations/jira-integration.md).
* **Microsoft Teams** — send monitor alerts to Teams channels. **Set up** walks you through creating a Teams workflow from the **Send webhook alerts to a channel** template; then click **Add Microsoft Teams channel** under **Alert channels** and paste the webhook link.
* **ServiceNow** — create ServiceNow tickets from incidents, by hand or automatically from monitors. See [ServiceNow Integration](https://docs.telm.ai/telmai/integrations/servicenow-integration.md).
* **Slack** — send monitor alerts to Slack channels. **Set up** walks you through creating a Slack app; then click **Add Slack channel** under **Alert channels**. See [Slack Integration](https://docs.telm.ai/telmai/integrations/slack-integration.md).

{% hint style="info" %}
Only one ticketing system, Jira or ServiceNow, can be connected at a time.
{% endhint %}

Jira and ServiceNow each keep their **Ticket templates** in their setting. To manage every alert channel in one place, open **Notification settings**. See [Configuring Notifications](https://docs.telm.ai/telmai/monitoring-data/monitors-management/configuring-notifications.md).

## Catalogs

Connect Telmai to a data catalog to bring in catalog tables, push data quality results back, and get monitoring recommendations.

* **Actian Data Intelligence** — see [Actian Data Intelligence Catalog](https://docs.telm.ai/telmai/integrations/catalog-integration/zeenea.md).
* **Alation** — see [Alation Integration](https://docs.telm.ai/telmai/integrations/alation-integration.md).
* **Atlan** — see [Atlan Catalog](https://docs.telm.ai/telmai/integrations/catalog-integration/atlan.md).
* **Databricks Unity Catalog** — see [Databricks Unity Catalog](https://docs.telm.ai/telmai/integrations/catalog-integration/databricks-unity-catalog.md).
* **Microsoft Fabric OneLake** — see [Microsoft Fabric OneLake](https://docs.telm.ai/telmai/integrations/catalog-integration/microsoft-fabric-onelake.md).

{% hint style="info" %}
A tenant can connect one catalog at a time. If you open another catalog while one is connected, the setting says which catalog is connected and links to it; remove that one first.
{% endhint %}

## Advanced settings

### Application settings

* **Sample records** — when **Enabled**, new assets keep sample records from each scan, so people can drill down to the records behind a value. You can also turn this on or off for each asset in its **Settings** tab. On hybrid deployments it's locked off, because hybrid scans run in your environment and don't collect sample records.
* **Scan usage and limits** — the scheduled and manual scans run in this tenant **Today**, **This week** and **This month**, against their limits. At a limit, new scans fail until the period resets. If you can change the limits, click **Edit limits**.

### Hybrid configuration

Configure the data plane of a hybrid deployment: the agent, its credentials and its provisioning. See [Hybrid deployment](https://docs.telm.ai/telmai/deployment-models/hybrid-deployment.md).

### Managed identities

Manage the Azure managed identities that connections can use to authenticate. See [Azure Managed Identity Authentication](https://docs.telm.ai/telmai/connect-to-data/data-connections/sql-server-managed-identity.md).

### Notification settings

Under **Message frequency**, choose how often monitors send messages. This applies to every alert channel.

| Mode          | What is sent                                                                                                                                                                   |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Each incident | A message for every new incident, with its chart and details.                                                                                                                  |
| Scan summary  | One message when each scan finishes, summarizing what it found.                                                                                                                |
| Digest        | One message every few minutes summarizing the new incidents. Incidents found within the interval are grouped into one message. Set the interval in **Digest every (minutes)**. |

Click **Save changes** to save. Under **Alert channels**, **Manage alert channels** opens every channel the monitors can notify. See [Configuring Notifications](https://docs.telm.ai/telmai/monitoring-data/monitors-management/configuring-notifications.md).

### Spark configuration

Tune the Spark jobs that run your scans. **Cluster** shows the **Spark platform**; under **Spark properties**, set the properties to pass to Spark, then click **Save changes**. **Reset to default** restores the defaults. See the [Spark Job Config API](https://docs.telm.ai/telmai/api-reference/spark-job-config-api.md).
