Skip to content

[DOC-1090][DOC-1015][2025.2] yb-tablet-metadata and additional views for pg-stat-statements #29465

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
aishwarya24 wants to merge 4 commits into
base: master
Choose a base branch
from
+330 −36
Open

[DOC-1090][DOC-1015][2025.2] yb-tablet-metadata and additional views for pg-stat-statements #29465

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
00bdb2f
added docs for yb-tablet-metadata nd additional other views
aishwarya24 Nov 24, 2025
45763b5
Apply suggestions from code review
aishwarya24 Nov 28, 2025
083e914
change from review
aishwarya24 Nov 28, 2025
276ed27
review comments
aishwarya24 Dec 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 10 additions & 2 deletions docs/content/stable/explore/observability/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -85,10 +85,18 @@ To understand how to view live queries, see [pg_stat_activity](./pg-stat-activit

## Tablet information

The yb_local_tablets view provides information about the how your table data is distributed across the different tablets in your cluster.
YugabyteDB provides two views for accessing tablet metadata:

- **yb_local_tablets**: Provides information about tablets on a specific node/server. This view returns the same information that is available on `<yb-tserver-ip>:9000/tablets`.

- **yb_tablet_metadata**: Provides cluster-wide tablet distribution and leadership information, including replica locations and leader nodes. This view serves as the YSQL equivalent of the YCQL `system.partitions` table.

{{<lead link="./yb-local-tablets">}}
To understand how to view and use tablet metadata, see [yb_local_tablets](./yb-local-tablets)
To view tablet metadata for a specific node, see [yb_local_tablets](./yb-local-tablets)
{{</lead>}}

{{<lead link="./yb-tablet-metadata">}}
To view cluster-wide tablet distribution and leadership, see [yb_tablet_metadata](./yb-tablet-metadata)
{{</lead>}}

## Terminated queries
Expand Down
6 changes: 2 additions & 4 deletions docs/content/stable/explore/observability/yb-local-tablets.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,10 +1,8 @@
---
title: View metadata for YSQL/YCQL/system tablets on a server
linkTitle: Tablet metadata
linkTitle: Local tablet metadata
description: View metadata for YSQL, YCQL, and system tablets on a server.
headerTitle: View metadata for YSQL/YCQL/system tablets on a server
tags:
feature: tech-preview
menu:
stable:
identifier: yb-local-tablets
Expand All @@ -17,7 +15,7 @@ Use YSQL `yb_local_tablets` view to fetch the metadata for [YSQL](../../../api/y

While debugging a system with [Active Session History](../active-session-history/), the `tablet_id` column of this view can be joined with the `wait_event_aux` column of the [yb_active_session_history](../../../launch-and-manage/monitor-and-alert/active-session-history-monitor/#yb-active-session-history) view. For example, see [Detect a hot shard](../active-session-history/#detect-a-hot-shard).

The columns of the `yb_local_tablets` view are described in the following table.
The following table describes the columns of the `yb_local_tablets` view.

| Column | Type | Description |
| :----- | :--- | :---------- |
Expand Down
Loading