OceanBase
English日本語简体中文
Docs Home
Products
Integrations
Release Notes

Databases

OceanBase DatabaseOceanBase AI DatabaseOceanBase Cloud OceanBase Best Practices

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog ServiceOceanBase DataPilotOceanBase OAgent

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Databases

OceanBase DatabaseOceanBase AI DatabaseOceanBase Cloud OceanBase Best Practices

Connectors and Middleware

OceanBase Database Proxy OceanBase Connector/C OceanBase Connector/J OceanBase Connector/ODBC OceanBase Connector/NETOceanBase Command-Line Client

Tools

OceanBase Cloud PlatformOceanBase Migration ServiceOceanBase Developer CenterOceanBase Migration AssessmentOceanBase Admin ToolOceanBase Loader and DumperOceanBase DeployerKubernetes operator for OceanBaseOceanBase Diagnostic Tool OceanBase Binlog ServiceOceanBase DataPilotOceanBase OAgent
OceanBase DatabaseOceanBase Cloud ToolsConnectors and MiddlewareLifecycle Support Policy

OceanBase OAgent

V2.2.0
  • Product overview
    • What is OAgent?
    • Key features
    • System architecture
    • Use cases
  • Quick start
  • Deployment
  • Overview
  • Sessions and diagnosis
    • Manage sessions
    • Switch dialogue models
    • Use @ to mention the analysis target
    • View the tool invocation process
    • Upload an attachment
    • Data visualization
    • FAQ
    • Export a report
  • Tools
  • Skill Management
  • Channel management
  • Knowledge base
    • Built-in knowledge base
    • Custom knowledge base
  • Scheduled tasks
    • Overview of scheduled tasks
    • Create a scheduled task
  • View usage
  • Model configuration
    • Manage model services
    • Model scoring
  • Settings and security
    • Product management
    • Experimental features
  • Best practices
    • Perform a cluster health inspection
    • Query cluster and topology information
    • Query resource metrics and task status
    • Read-only queries
    • Alert query and troubleshooting guide
    • Root cause analysis of exceptions
    • ASH diagnostic report
    • Analyze slow SQL, TopSQL, and abnormal SQL
    • SQL pre-analysis and tuning recommendations
    • Interpret execution plans
    • Diagnostic information statistics
    • Parameter check and change governance
    • Database change ticket
  • Appendix
    • Feature list
    • Built-in Skills
  • Release notes
    • OAgent V2.2.0 Release note
    • OAgent V2.1.0 Release note
    • OAgent V2.0.0 Release note
    • OAgent V1.8.0 Release note

Download PDF

Document Feedback
  1. Documentation Center
  2. OceanBase OAgent
  3. V2.2.0

Alert query and troubleshooting guide

Last Updated:2026-11-20 07:25:11

When to use
Prerequisites
Procedure
What to do next

You can query the current active alerts and historical alerts for a cluster through a conversation, and obtain handling suggestions for specific alert types.

When to use

  • Quickly understand which unresolved alerts are currently present in a cluster during your shift.

  • Received a certain type of alert but are unsure about the resolution steps and need troubleshooting guidance.

  • Need to review historical alerts from a specific period to determine if an issue is recurring.

Prerequisites

The OCP connection for the target cluster's product has been configured, and the alert data comes from OCP.

Procedure

  1. Type @ in the session to select the target cluster.

  2. Describe your query request, for example:

    What alerts are there in this cluster now?
    

    You can also click the shortcut entry Alert Analysis on the Create Conversation page and then provide the cluster information.

  3. Press Enter to send the request and wait for the Agent to complete the query.

    The Agent will query the list of active and historical alerts and display them summarized by alert level.

    The alert levels in OceanBase, from high to low, are as follows:

    Alert Level
    Description
    Down A service-unavailability fault that requires immediate attention.
    Critical A severe alert that has affected or will soon affect business.
    Alert A general alert that requires prompt attention.
    Caution A warning alert; it is recommended to monitor it.
    Info An informational notification that does not require immediate handling.
  4. Further inquire about the handling method for a specific alert, for example:

    How should I handle this high CPU usage alert?
    

    The Agent provides troubleshooting step suggestions based on the Alert Handling Manual.

What to do next

  • If the alert indicates a performance issue, you can generate an ASH report to obtain evidence of active sessions. For more information, see ASH diagnostic report.

  • To regularly receive alert summaries, you can create a scheduled task. For more information, see Create a scheduled task.

Previous topic

Read-only queries
Last

Next topic

Root cause analysis of exceptions
Next
on this page
When to use
Prerequisites
Procedure
What to do next