OceanBase logo

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Resources

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS

OceanBase Cloud

OceanBase Database

Tools

Connectors and Middleware

QUICK START

OceanBase Cloud

OceanBase Database

BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Company

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

International - English
中国站 - 简体中文
日本 - 日本語
Sign In
Start on Cloud

OceanBase

A unified distributed database ready for your transactional, analytical, and AI workloads.

Product Overview
DEPLOY YOUR WAY

OceanBase Cloud

The best way to deploy and scale OceanBase

OceanBase Enterprise

Run and manage OceanBase on your infra

TRY OPEN SOURCE

OceanBase Community Edition

The free, open-source distributed database

OceanBase seekdb

Open source AI native search database

Customer Stories

Real-world success stories from enterprises across diverse industries.

View All
BY USE CASES

Mission-Critical Transactions

Global & Multicloud Application

Elastic Scaling for Peak Traffic

Real-time Analytics

Active Geo-redundancy

Database Consolidation

Comprehensive knowledge hub for OceanBase.

Blog

Live Demos

Training & Certification

Documentation

Official technical guides, tutorials, API references, and manuals for all OceanBase products.

View All
PRODUCTS
OceanBase CloudOceanBase Database
ToolsConnectors and Middleware
QUICK START
OceanBase CloudOceanBase Database
BEST PRACTICES

Practical guides for utilizing OceanBase more effectively and conveniently

Learn more about OceanBase – our company, partnerships, and trust and security initiatives.

About OceanBase

Partner

Trust Center

Contact Us

Start on Cloud
编组
All Products
    • Databases
    • iconOceanBase Database
    • iconOceanBase Cloud
    • iconOceanBase Tugraph
    • iconInteractive Tutorials
    • iconOceanBase Best Practices
    • Tools
    • iconOceanBase Cloud Platform
    • iconOceanBase Migration Service
    • iconOceanBase Developer Center
    • iconOceanBase Migration Assessment
    • iconOceanBase Admin Tool
    • iconOceanBase Loader and Dumper
    • iconOceanBase Deployer
    • iconKubernetes operator for OceanBase
    • iconOceanBase Diagnostic Tool
    • iconOceanBase Binlog Service
    • Connectors and Middleware
    • iconOceanBase Database Proxy
    • iconEmbedded SQL in C for OceanBase
    • iconOceanBase Call Interface
    • iconOceanBase Connector/C
    • iconOceanBase Connector/J
    • iconOceanBase Connector/ODBC
    • iconOceanBase Connector/NET
icon

OceanBase Cloud Platform

V4.3.5

    Download PDF

    OceanBase logo

    The Unified Distributed Database for the AI Era.

    Follow Us
    Products
    OceanBase CloudOceanBase EnterpriseOceanBase Community EditionOceanBase seekdb
    Resources
    DocsBlogWhite PaperLive DemosTraining & CertificationTicket
    Company
    About OceanBaseTrust CenterLegalPartnerContact Us
    Follow Us

    © OceanBase 2026. All rights reserved

    Cloud Service AgreementPrivacy PolicySecurity
    Contact Us
    Document Feedback
    1. Documentation Center
    2. OceanBase Cloud Platform
    3. V4.3.5
    iconOceanBase Cloud Platform
    V 4.3.5
    Databases
    • OceanBase Database
    • OceanBase Cloud
    • OceanBase Tugraph
    • Interactive Tutorials
    • OceanBase Best Practices
    Tools
    • OceanBase Cloud Platform
    • OceanBase Migration Service
    • OceanBase Developer Center
    • OceanBase Migration Assessment
    • OceanBase Admin Tool
    • OceanBase Loader and Dumper
    • OceanBase Deployer
    • Kubernetes operator for OceanBase
    • OceanBase Diagnostic Tool
    • OceanBase Binlog Service
    Connectors and Middleware
    • OceanBase Database Proxy
    • Embedded SQL in C for OceanBase
    • OceanBase Call Interface
    • OceanBase Connector/C
    • OceanBase Connector/J
    • OceanBase Connector/ODBC
    • OceanBase Connector/NET
    • V 4.4.2
    • V 4.3.6
    • V 4.3.5
    • V 4.3.4
    • V 4.3.3
    • V 4.3.2
    • V 4.3.1
    • V 4.3.0
    • V 4.2.2
    • V 4.0.0 and earlier

    ob_host_connection_percent_over_threshold

    Last Updated:2026-04-16 03:36:04  Updated
    Share
    What is on this page
    Description
    Principle
    Alert rule
    Alert information
    Alert templates
    Impact on the system
    Possible cause
    Suggested solutions

    folded

    Share

    Description

    This alert is triggered when the ratio of current connections of an OBServer to the constant value 256000 exceeds the threshold.

    Principle

    The following table describes the key parameters that are involved in the monitoring and alerting logic.

    Parameter
    Value
    Metric ob_host_connection_percent
    Source SQL: select/*+ READ_CONSISTENCY(WEAK) */ case when cnt is null then 0 else cnt end as cnt, tenant_name from (select __all_tenant.tenant_name, cnt from __all_tenant left join (select count(*) as cnt, tenant as tenant_name from __all_virtual_processlist where svr_ip = @svr_ip and svr_port=rpc_port() group by tenant) t1 on __all_tenant.tenant_name = t1.tenant_name) t2;
    Note
    The sum of values of the cnt fields is used as the value of the active_sessions metric.
    Collected metric active_sessions
    Metric expression 100 * max(active_sessions{metric_group="all_virtual_processlist",@LABELS} / 262144) by (@GBLABELS)
    Collection cycle 1 second

    The value of the metric ob_host_connection_percent indicates the ratio of connections of the OBServer to the constant value 256000.

    When this value exceeds the threshold, this alert is triggered. The default threshold is 80%, which is equivalent to the case where the value of the active_sessions metric is 209715.

    Alert rule

    Metric
    Default threshold (unit: %)
    Detection cycle
    Time before clearance
    ob_host_connection_percent 80 60 seconds 5 minutes

    Alert information

    Trigger method
    Alert level
    Scope
    Metric expression Critical Server

    Alert templates

    • Overview: ${alarm_target} ${alarm_name}

    • Details: Cluster:${ob_cluster_name}, Host:{host}, Alert: The ratio of connections of the OBServer to the constant value 256000 is ${value}%, exceeding the threshold of ${alarm_threshold}%.

    • Overview example: ob_cluster=C1-1000:svr_ip=xxx.xxx.xxx.xxx. The ratio of connections of the OBServer to the constant value 256000 exceeds the threshold.

    • Details example: ob_cluster=C1-1000:svr_ip=xxx.xxx.xxx.xxx. The ratio of connections of the OBServer to the constant value 256000 is 81.0%, exceeding the threshold of 80.0%.

    Impact on the system

    New connections cannot be created if the ratio of connections of the OBServer to the constant value 256000 exceeds the threshold.

    Possible cause

    This problem is commonly found in cases where the ratio of connections of a single OBServer to the constant value 256000 exceeds the threshold.

    Suggested solutions

    Execute the following SQL statement to locate the tenants with the most connections.

    -- Connect to the sys tenant.
    
     -- Query the top 5 tenants with the most OBServer connections.
    SELECT tenant, svr_ip, COUNT(*) AS session_num FROM __all_virtual_processlist GROUP BY tenant, svr_ip ORDER BY session_num DESC limit 5;
    
    -- Sample response
    -- The sys tenant is a system tenant of the OceanBase cluster instead of a business tenant.
    +------------+----------------+-------------+
    | tenant     | svr_ip         | session_num |
    +------------+----------------+-------------+
    | test1      | xxx.xxx.xxx.xxx |       66664 |
    | test1      | xxx.xxx.xxx.xxx |       66560 |
    | test1      | xxx.xxx.xxx.xxx  |         559 |
    | test2      | xxx.xxx.xxx.xxx |          78 |
    | test2      | xxx.xxx.xxx.xxx |          57 |
    +------------+----------------+-------------+
    5 rows in set (0.02 sec)
    

    Contact the customer of the tenant with abnormal connections and ask them to check for unwanted connections.

    • If all connections are necessary, scale out the cluster to solve the problem of insufficient connections.

      Scaling out a cluster means adding OBServers to the OceanBase cluster. For more information, see Add an OBServer.

    • If some connections are not necessary, query the all_virtual_processlist table to find the sources of unnecessary connections.

    Previous topic

    ob_cpu_percent_over_threshold
    Last

    Next topic

    ob_host_disk_readonly
    Next
    What is on this page
    Description
    Principle
    Alert rule
    Alert information
    Alert templates
    Impact on the system
    Possible cause
    Suggested solutions