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

# Welcome

Datasentinel is an observability platform for PostgreSQL. It monitors your clusters, keeps the history of their activity, and helps you find what slows them down. This documentation covers its install

## What is Datasentinel?

Datasentinel is an observability platform for PostgreSQL: it monitors your instances and helps you analyze their performance. It collects the activity of your instances, keeps its history, and shows it in dashboards you can filter, zoom and compare.

<figure><picture><source srcset="https://1072624949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlcWi6G1jtNuyGT9C0pkc%2Fuploads%2Fgit-blob-b1e1d6ddccd9789884222bdb33eb068677228987%2Fhome-page-dark.svg?alt=media" media="(prefers-color-scheme: dark)"><img src="https://1072624949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlcWi6G1jtNuyGT9C0pkc%2Fuploads%2Fgit-blob-4c48cab084c88ff4bd77c818f533d11d39703b9b%2Fhome-page.svg?alt=media" alt="Animated illustration of the Datasentinel home page. It lists the monitored PostgreSQL instances with their tags, status, version, size, load against the number of CPUs, sessions, and sessions on CPU and on I/O. A filter on the tag environment = production is added, and the list narrows from 11 to 7 instances. Below, each instance has its own activity chart with the CPU limit, and a second chart for a metric of your choice, switched here from sessions to WAL size."></picture><figcaption><p>The home page: all your PostgreSQL instances at a glance</p></figcaption></figure>

With Datasentinel, you can:

* **See the whole fleet at a glance**, from a single instance to hundreds of clusters.
* **Go back in time** to analyze an incident: sessions, queries, tables, locks and system metrics are all kept with their history.
* **Find the cause of a slowdown**: the queries behind a peak, the session that blocked the others, the parameter that changed.
* **Act in real time** on a live instance: current sessions, blocking, execution plans.
* **Be notified** when a rule is breached, and share an analysis as a PDF report.
* **Ask an AI assistant**, in plain language, through AI Connector.

{% hint style="info" %}
Datasentinel works with self-managed PostgreSQL, cloud-managed databases and containers. It is available on-premises or in SaaS mode.
{% endhint %}

## Key Features

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Session History</strong></td><td>What an instance was doing at any time, by wait event, query, user or application.</td><td><a href="https://docs.datasentinel.io/manual/features/key-features/session-history.md">Session History</a></td></tr><tr><td><strong>Top Queries</strong></td><td>The most consuming queries, ranked by the metric of your choice.</td><td><a href="https://docs.datasentinel.io/manual/features/key-features/top-queries.md">Top Queries</a></td></tr><tr><td><strong>Top Tables</strong></td><td>Table and index activity, size and maintenance indicators.</td><td><a href="https://docs.datasentinel.io/manual/features/key-features/top-tables.md">Top Tables</a></td></tr><tr><td><strong>Lock Explorer</strong></td><td>Who blocked whom, with the queries and the locks.</td><td><a href="https://docs.datasentinel.io/manual/features/key-features/lock-explorer.md">Lock Explorer</a></td></tr><tr><td><strong>Cluster &#x26; System Metrics</strong></td><td>PostgreSQL activity, replication, WAL, CPU, memory, disks and network.</td><td><a href="https://docs.datasentinel.io/manual/features/key-features/cluster-and-system-metrics.md">Cluster &amp; System Metrics</a></td></tr><tr><td><strong>Live360</strong></td><td>What is happening right now: sessions, blocking, plans, disk and cache usage.</td><td><a href="https://docs.datasentinel.io/manual/features/key-features/live360.md">Live360</a></td></tr><tr><td><strong>Reporting</strong></td><td>PDF reports, downloaded, emailed or scheduled.</td><td><a href="https://docs.datasentinel.io/manual/features/key-features/reporting.md">Reporting</a></td></tr><tr><td><strong>Alerting</strong></td><td>Rules, and notifications by email, webhook or script.</td><td><a href="https://docs.datasentinel.io/manual/features/key-features/alerting.md">Alerting</a></td></tr></tbody></table>

See all of them in [Key Features](https://docs.datasentinel.io/manual/features/key-features.md), and the complements in [Other Features](https://docs.datasentinel.io/manual/features/other-features.md) and [Tips & Hints](https://docs.datasentinel.io/manual/features/tips-and-hints.md).

## AI Connector

**AI Connector** opens Datasentinel metrics to AI assistants. Ask a question in plain language: the assistant analyzes your PostgreSQL workload, explains what it finds, and turns the evidence into concrete recommendations.

<figure><picture><source srcset="https://1072624949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlcWi6G1jtNuyGT9C0pkc%2Fuploads%2Fgit-blob-fd0e1055a6410917d6b3acb96f35a38adaf2bef8%2Fai-connector-overview-dark.svg?alt=media" media="(prefers-color-scheme: dark)"><img src="https://1072624949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlcWi6G1jtNuyGT9C0pkc%2Fuploads%2Fgit-blob-6a3960903b1b48c40e626efcb799883429cff51f%2Fai-connector-overview.svg?alt=media" alt="An AI assistant asks a question in plain language; the request goes through AI Connector (MCP server and Skill) to the Datasentinel platform, which reads PostgreSQL metrics; findings ordered by impact and a recommendation come back."></picture><figcaption></figcaption></figure>

It is made of two parts:

* **An MCP server**, bundled with the platform from release 2026.10, which exposes Datasentinel's metrics to AI assistants over the [Model Context Protocol](https://modelcontextprotocol.io/).
* **A Skill**, which tells the assistant how to use the MCP server: which tools to call, in what order, and how to turn the results into analyses and recommendations.

The assistant can investigate past workload (the data behind [Session History](https://docs.datasentinel.io/manual/features/key-features/session-history.md) and [Top Queries](https://docs.datasentinel.io/manual/features/key-features/top-queries.md)), troubleshoot a live instance through [Live360](https://docs.datasentinel.io/manual/features/key-features/live360.md), compare workloads, and produce PDF reports. Any assistant that supports MCP and Skills works: Claude, OpenAI Codex and ChatGPT, GitHub Copilot, Microsoft Copilot Studio, Cursor, and more. Every analysis stays read-only, and each user signs in with their own Datasentinel account, so the platform's access rights apply.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Discover AI Connector</strong></td><td>What it enables, how it works, and how to get started.</td><td><a href="https://docs.datasentinel.io/manual/ai-connector">https://docs.datasentinel.io/manual/ai-connector</a></td></tr><tr><td><strong>Try it on the sandbox</strong></td><td>A public platform monitoring about 20 PostgreSQL instances, with shared read-only credentials and nothing to install.</td><td><a href="https://docs.datasentinel.io/manual/ai-connector/test-with-the-sandbox-platform">https://docs.datasentinel.io/manual/ai-connector/test-with-the-sandbox-platform</a></td></tr><tr><td><strong>Connect your assistant</strong></td><td>Register the MCP server and install the Skill in any compatible assistant.</td><td><a href="https://docs.datasentinel.io/manual/ai-connector/connect-a-cli-assistant/connect-a-compatible-assistant">https://docs.datasentinel.io/manual/ai-connector/connect-a-cli-assistant/connect-a-compatible-assistant</a></td></tr><tr><td><strong>What you can analyze</strong></td><td>Workload, queries, tables, replication, live sessions, host metrics and more.</td><td><a href="https://docs.datasentinel.io/manual/ai-connector/analyze-and-tune-workloads/what-you-can-analyze">https://docs.datasentinel.io/manual/ai-connector/analyze-and-tune-workloads/what-you-can-analyze</a></td></tr></tbody></table>

## How it works

Datasentinel has two parts.

* **The platform** stores the metrics and displays them. You install it on your own server, or Datasentinel hosts it for you in SaaS mode.
* **The collection** reads the metrics from your PostgreSQL clusters: with an agent installed on the database server, or without one, through a remote connection from the platform.

Both collection methods can be mixed on the same platform. See the [Architecture](https://docs.datasentinel.io/manual/getting-started/architecture.md).

## Getting Started

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Free Trial</strong></td><td>Try Datasentinel for 60 days, on-premises or in SaaS mode.</td><td><a href="https://docs.datasentinel.io/manual/free-trial.md">Free Trial</a></td></tr><tr><td><strong>Architecture</strong></td><td>The platform, the two collection methods and the deployments.</td><td><a href="https://docs.datasentinel.io/manual/getting-started/architecture.md">Architecture</a></td></tr><tr><td><strong>Installation</strong></td><td>Install the platform, then the agents or the agentless connections.</td><td><a href="https://docs.datasentinel.io/manual/getting-started/installation.md">Installation</a></td></tr><tr><td><strong>PostgreSQL clusters</strong></td><td>Prepare a cluster: extensions, monitoring user, connection.</td><td><a href="https://docs.datasentinel.io/manual/getting-started/postgresql-clusters.md">PostgreSQL clusters</a></td></tr></tbody></table>

You can also look at the product right away on the [live demo](https://www.datasentinel.io/demo), with nothing to install.

## Find your way in this documentation

| You want to                                        | Go to                                                                                                                                                                                     |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Install Datasentinel and connect your clusters     | [Installation](https://docs.datasentinel.io/manual/getting-started/installation.md) and [PostgreSQL clusters](https://docs.datasentinel.io/manual/getting-started/postgresql-clusters.md) |
| Understand what a dashboard shows                  | [Key Features](https://docs.datasentinel.io/manual/features/key-features.md)                                                                                                              |
| Configure the platform: license, users, LDAP, SMTP | [Configuration](https://docs.datasentinel.io/manual/implementation/platform-usage/configuration.md)                                                                                       |
| Automate with the API                              | [API Reference](https://docs.datasentinel.io/manual/implementation/platform-usage/api-reference.md)                                                                                       |
| Operate an agent                                   | [Agent Usage](https://docs.datasentinel.io/manual/implementation/agent-usage.md)                                                                                                          |
| Upgrade the platform or the agents                 | [Upgrade](https://docs.datasentinel.io/manual/implementation/upgrade.md)                                                                                                                  |
| Diagnose a problem                                 | [Troubleshooting](https://docs.datasentinel.io/manual/implementation/troubleshooting.md) and [FAQs](https://docs.datasentinel.io/manual/getting-started/faqs.md)                          |
| Reach the support team                             | [How to Contact Us](https://docs.datasentinel.io/manual/support/how-to-contact-us.md)                                                                                                     |

## Explore this documentation from your AI assistant

This documentation is published with GitBook, which serves it through its own **MCP server**. Add that server to your AI assistant, and it answers product questions from the documentation, with links to the pages: what a setting does, how to configure an alert, what an API route returns.

<figure><picture><source srcset="https://1072624949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlcWi6G1jtNuyGT9C0pkc%2Fuploads%2Fgit-blob-c47f5cc884b2c90fbad59e237299601a12443574%2Fexplore-the-documentation-dark.svg?alt=media" media="(prefers-color-scheme: dark)"><img src="https://1072624949-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlcWi6G1jtNuyGT9C0pkc%2Fuploads%2Fgit-blob-587832defe1403e228d9e42a2208fad59b051015%2Fexplore-the-documentation.svg?alt=media" alt="Animated illustration with two example questions asked to an AI assistant connected to the Datasentinel documentation MCP server, named docs-datasentinel. Example 1: the user asks how to install Datasentinel. The assistant calls searchDocumentation, the pages Installation, Platform and Installation, Agent match, and it answers in three steps: install the platform on a dedicated Linux machine, enable your license key, then connect your PostgreSQL instances with one agent per server or agentless connections. Example 2: the user asks what the prerequisites are in PostgreSQL. The pages PostgreSQL clusters, Extensions and Monitoring User match, and the assistant answers: PostgreSQL 9.4 or later, the pg_stat_statements extension installed in the postgres database, a read-only monitoring user with pg_monitor, pg_read_all_settings and pg_read_all_stats, and the optional extensions pg_store_plans, system_stats and pg_buffercache. Each answer ends with links to the source pages."></picture><figcaption><p>Two product questions, answered from the documentation with links to the pages.</p></figcaption></figure>

|                |                                                    |
| -------------- | -------------------------------------------------- |
| URL            | `https://docs.datasentinel.io/manual/~gitbook/mcp` |
| Transport      | Streamable HTTP                                    |
| Authentication | None: the documentation is public                  |
| Access         | Read-only                                          |

The server needs no token and no sign-in, and it never sees your monitoring data. Register it in any MCP client as a remote HTTP server with that URL, for example in Claude Code:

```bash
claude mcp add --scope user --transport http docs-datasentinel https://docs.datasentinel.io/manual/~gitbook/mcp
```

Then ask, for example: *"Search the Datasentinel documentation: what are the PostgreSQL prerequisites?"*

{% hint style="warning" %}
**Do not name this server with the `datasentinel-` prefix.** The Datasentinel Skill of [AI Connector](#ai-connector) treats every server named `datasentinel-*` as a monitoring platform. Name it `docs-datasentinel`, as above.
{% endhint %}

The commands for the other assistants (Claude apps, Codex CLI, Copilot CLI, Antigravity CLI, VS Code, Cursor) are in [Explore the documentation from your assistant](https://docs.datasentinel.io/manual/ai-connector/use-the-assistant/explore-the-documentation).

## Licensing information

Datasentinel is a commercial software solution. It is sold as an annual subscription, priced by the number of PostgreSQL instances. An instance is a running PostgreSQL database cluster.

AI Connector is an add-on, enabled by the license.

You can try Datasentinel free of charge for 60 days. See the [Free Trial](https://docs.datasentinel.io/manual/free-trial.md). For licensing options, contact our [sales team](mailto:sales@datasentinel.io).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.datasentinel.io/manual/welcome.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
