文档中心

AI 原生 BaaS 平台 Supabase 版

使用 Supabase 控制台

可观测性

AI 原生 BaaS 平台 Supabase 版（以下简称"火山引擎 Supabase"）为 Data API、Auth、Edge Functions、Storage 和 Realtime 五个核心模块提供了独立的可观测性监控页面。您可以在控制台中查看各模块的请求量、错误率、响应耗时以及用户活跃等关键指标，帮助您实时了解应用的运行状况和终端用户的使用行为。

前提条件

已创建使用 Supabase 引擎的 Workspace 且 Workspace 的状态为运行中。关于创建 Workspace 的更多详细信息，请参见创建 Workspace。

已通过目标 Workspace 成功登录 Supabase 控制台。关于登录控制台的详细信息，请参见登录 Supabase 控制台。

注意事项

自 2026 年 8 月 20 日起，Report 页面正式升级为 Observability，提供更丰富的观测能力。

操作步骤

进入可观测性页面

在左侧导航栏中，单击 Observability。

在 GENERAL 或 PRODUCT 区域，选择需要查看的模块：

GENERAL

Overview：提供 Service Health（服务健康）总览。

Query Performance：提供 SQL 语句级的性能分析信息。

API Gateway：展示经过 API 网关的所有请求的汇总监控数据。

PRODUCT

Data API：查看通过 Data API（PostgREST）访问数据库的请求指标。

Auth：查看用户认证相关的使用情况、错误和性能指标。

Edge Functions：查看边缘函数的调用次数、状态码和执行时长。

Storage：查看对象存储的请求量、错误率和响应耗时。

Realtime：查看实时通信服务的请求指标。

选择时间范围

在各监控页面顶部，您可以通过时间选择器设定数据展示的时间范围，支持近 10 分钟、近 30 分钟、近 60 分钟、近 3 小时、近 24 小时、近 7 天、近 14 天、近 28 天等常用选项。图表将根据所选范围自动调整时间粒度。

添加筛选条件

仅 API Gateway、Data API、Storage、Realtime 和 Auth API Gateway 监控页面支持添加筛选条件。单击 + Add filter 按钮，可在当前时间范围内对监控数据进行属性筛选，精确定位目标请求或响应。筛选条件由以下三项组成：

Attribute Filter：选择筛选的维度，支持以下属性：

request.path：请求路径

request.method：请求方法

request.search：请求查询参数

request.headers.x_client_info：客户端信息请求头

request.headers.user_agent：User-Agent 请求头

response.status_code：响应状态码

Comparison：支持 is（精确匹配）和 matches（正则匹配）。

Value：输入筛选的目标值（字符串类型）。

设置完成后单击 Add filter 按钮即可应用。可添加多个筛选条件，条件间取交集。

刷新数据

单击页面顶部的刷新按钮，可手动拉取最新监控数据。

监控指标说明

Overview

Overview 页面位于 Observability 左侧导航的 GENERAL 分组下，提供 Service Health（服务健康）总览。页面以缩略图形式展示以下 6 个服务在选定时间范围内的请求趋势：

API Gateway

PostgREST

Auth

Edge Functions

Storage

Realtime

单击各服务缩略图右上角的箭头，可跳转至对应模块的详细监控页面。页面右上角支持选择时间范围（Last 60 minutes、Last 24 hours 和 Last 7 days ）和手动刷新。

Query Performance

Query Performance 页面位于 Observability 左侧导航的 GENERAL 分组下，实际嵌入 Advisors > Query Performance 页面的内容。

页面顶部展示以下三项汇总指标：

Slow Queries（慢查询数）：当前分析报告中识别到的慢查询 SQL 数量。

Cache Hit Rate（缓存命中率）：数据库缓存命中率百分比。

Avg. Rows Per Call（平均每次调用返回行数）。

页面主体为 SQL 语句级的性能分析表格，包含以下列：Query（SQL 语句）、Time consumed（耗时占比）、Count（执行次数）、Max time（最大耗时）、Mean time（平均耗时）、Min time（最小耗时）、Rows processed（处理行数）、Cache hit rate（缓存命中率）、Role（执行角色）。

表格支持按 query 内容搜索和按 Roles 筛选。单击某条 SQL 语句可查看详情；页面右上角提供 Enable Index Advisor 按钮，可启用索引建议功能。

该报告基于 pg_stat_statements 表和 pg_stat_statements 扩展生成。单击 Reset report 可重置分析数据（建议在完成查询优化后重置）。Source 支持切换为 Primary Database 或 Replica。

API Gateway

API Gateway 页面展示经过 API 网关的所有请求的汇总监控数据，包含以下指标模块：

指标	说明
Total Requests	展示选定时间范围内的总请求数，以及 Average TPS（平均每秒请求数）和 Peak TPS（峰值每秒请求数）；并以列表形式展示请求路径和 HTTP 方法的请求次数排行，单击可展开查看详情。
Response Errors	展示选定时间范围内的响应错误数量趋势。
Response Speed	展示选定时间范围内的响应耗时趋势，以及各请求路径的平均响应时间排行。

页面支持单击 + Add filter 添加筛选条件，筛选器参数与 Data API、Storage、Realtime 相同，详见"添加筛选条件"章节。页面右上角支持选择时间范围和手动刷新。

API Gateway 页面还支持按 Request 类型筛选。通过页面左上角的下拉菜单可选择查看指定类型的请求，支持以下选项：

All Requests：显示所有请求。

Data API (PostgREST)：仅显示通过 PostgREST 发起的数据库 API 请求。

Auth：仅显示 Auth 服务相关请求。

Storage：仅显示 Storage 服务相关请求。

Realtime：仅显示 Realtime 服务相关请求。

GraphQL (pg_graphql)：仅显示 GraphQL 请求。

Data API

Data API 监控页面展示通过 PostgREST 接口访问数据库的请求情况，包含以下指标：

指标	说明
Tables Without RLS Policies	已开启 RLS 但未配置策略的表数，每 30 秒刷新一次。
Total Requests	展示选定时间范围内的 Data API 请求总量，并以柱状图呈现各时间桶的请求分布。同时显示 Average TPS（平均每秒事务数）和 Peak TPS（峰值 TPS）。下方表格按请求方法、HTTP 状态码和路径列出各请求的调用次数。
Response Errors	展示选定时间范围内的错误请求数量及分时分布，帮助您快速定位异常接口。
Response Speed	展示选定时间范围内 Data API 请求的平均响应耗时（毫秒），并以柱状图呈现各时间桶的耗时变化。下方表格按请求路径列出平均耗时，便于识别慢请求。

Auth

Auth 监控页面展示用户认证模块的运营和性能数据，分为以下几个部分。

Usage

Usage 指标如下表所示。

指标	说明
Registered Users Total	展示截至当前的注册用户总量及随时间的变化趋势。该数据直接查询数据库，不受日志保留周期限制。
Trailing Auth Active Days	以分布图展示用户连续进行 Auth 认证活动的天数区间，帮助您了解用户粘性。
Auth Daily Active Users	展示每日通过认证的去重活跃用户数（DAU），按 UTC 自然日统计。
Auth Daily Active Users (%)	展示每日活跃用户数占累计注册用户总数的百分比，计算公式为：当日活跃用户数 ÷ 截至当日累计注册用户数 × 100%。
Active Users	展示选定时间范围内携带有效用户身份的去重活跃用户数变化趋势。
Sign In Attempts by Type	按登录方式（如密码登录、Token 刷新、第三方登录等）分类展示登录请求数量。
Sign Ups	展示选定时间范围内的注册成功数量及趋势。
Password Reset Requests	展示选定时间范围内的密码重置请求数量。

Usage 指标支持按登录方式进行筛选查看。支持的登录方式（Provider）如下表所示。

类型	Provider
邮箱 / 手机	Email、Phone、Magic Link、Email Change
社交账号	Google、Apple、GitHub、GitLab、Facebook、Twitter、Discord、Kakao、LinkedIn、LinkedIn OIDC、Twitch、Spotify、Snapchat、Notion、Figma、Zoom、Slack OIDC、WorkOS
企业 / SSO	Azure、SAML、SSO/SAML、Keycloak
多因素认证	TOTP（基于时间的一次性密码）、Recovery（恢复码）

Monitoring

指标	说明
API Gateway Auth Errors	展示经过 API 网关的 Auth 请求中返回错误状态码的请求数量及分时趋势，可按状态码或错误类型筛选。

Monitoring 指标支持按 Status Code 进行筛选查看。Status Code 由以下两项组成：

Operator（运算符）：支持 = Equals（等于）、>= Greater than or equal to（大于等于）、<= Less than or equal to（小于等于）、> Greater than（大于）、< Less than（小于）、!= Not equal to（不等于）。

Value（值）：输入目标状态码（如 200、500 等）。

Performance

指标	说明
Sign In Processing Time	展示登录请求的处理耗时，支持查看平均值、最大值以及 P50、P95、P99 分位数。
Sign In Processing Time Percentiles	以分位图形式展示登录耗时的百分位分布，帮助您了解长尾延迟情况。

Auth API Gateway

指标	说明
Total Requests	展示经过 API 网关的 Auth 请求总量、Average TPS 和 Peak TPS，支持按路径、状态码等维度筛选。
Response Errors	展示 Auth 请求的错误数量及分时分布。
Response Speed	展示 Auth 请求的平均响应耗时及各路径的平均耗时排名。

Edge Functions

Edge Functions 监控页面展示边缘函数的调用和执行情况。页面顶部支持按 Function 和 Status Code 进行筛选。

具体筛选方式如下：

Function：从下拉列表中搜索并选择目标函数名称，单击 Apply 应用。

Status Code：设置响应状态码的筛选条件，由以下两项组成：

Operator（运算符）：支持 = Equals（等于）、>= Greater than or equal to（大于等于）、<= Less than or equal to（小于等于）、> Greater than（大于）、< Less than（小于）、!= Not equal to（不等于）。

Value（值）：输入目标状态码（如 200、500 等）。

设置完成后单击 Apply 按钮即可应用，单击 Clear 可清除筛选条件。

指标	说明
Total Edge Function Invocations	展示选定时间范围内所有 Edge Function 的调用总量及分时趋势。
Edge Function Status Codes	展示各 HTTP 状态码的请求数量分布，帮助您快速识别函数执行异常。
Edge Function Execution Time	展示 Edge Function 的执行耗时，支持查看不同聚合维度（平均值、P95 等）下的耗时数据。

Storage

Storage 监控页面展示对象存储服务的请求情况。

指标	说明
Total Requests	展示选定时间范围内的 Storage 请求总量、Average TPS 和 Peak TPS，并以柱状图呈现分时请求分布。下方表格按请求方法、状态码和路径列出各请求的调用次数。
Response Errors	展示 Storage 错误请求的数量及分时趋势。
Response Speed	展示 Storage 请求的平均响应耗时（毫秒），下方表格按请求路径列出平均耗时。

Realtime

Realtime 监控页面展示实时通信服务通过 API 网关处理的请求情况。

指标	说明
Total Requests	展示选定时间范围内 Realtime 服务的请求总量、Average TPS 和 Peak TPS。
Response Errors	展示 Realtime 请求的错误数量及分时分布。
Response Speed	展示 Realtime 请求的平均响应耗时变化。

注意事项

监控数据的刷新可能存在延迟，新产生的请求数据最长可能需要 24 小时才能在图表中完整展示。

基于日志的指标（如请求数、错误数、响应耗时等）受日志保留周期限制。日志默认保留 30 天，超出保留期的历史数据无法查询。

基于数据库实时查询的指标（如累计注册用户数、未配置 RLS 策略的表数量）不受日志保留周期限制，但用户被物理删除后，相关历史数据无法还原。

Average TPS 和 Peak TPS 基于选定时间范围内的请求数据计算，时间范围越大，数值的统计区间越长。

各模块的监控数据按项目（Project）维度隔离，不同项目之间的数据互不可见。

常见问题与故障排查

为什么监控页面显示"No data to show"？

如果您的实例是新创建的，或选定时间范围内没有对应模块的请求流量，页面将显示"No data to show"。请确认实例已有实际流量，并尝试扩大时间范围。此外，数据刷新存在延迟，新产生的请求数据最长可能需要 24 小时才能展示。

为什么只能查看近 30 天的数据？

基于日志的监控指标默认保留 30 天。如需更长时间的数据留存，请联系技术支持。

最近更新时间：2026.08.25 12:34:59

这个页面对您有帮助吗？

有用

无用