When a znode changes on a Microservices Engine (MSE) ZooKeeper instance, connected clients receive the change event. If a client does not receive the change event pushed from the instance, troubleshooting becomes difficult. Data tracks provide visibility by recording all znode change events and their push status, improving troubleshooting efficiency.
Query by znode path to view change records and push status, or query by client session ID to inspect what a specific client received.
Prerequisites
Before you begin, make sure that you have:
A ZooKeeper engine running version V3.8.0.2 or later. To upgrade an existing engine, see Upgrade a ZooKeeper version. To create a new engine, see Create a ZooKeeper engine
Query data tracks
-
Log on to the MSE console, and select a region in the top navigation bar.
-
In the left-side navigation pane, choose Microservices Registry > Instances.
-
On the Instances page, click the name of the instance.
In the left-side navigation pane, choose Data Management > Data Tracks.
Select a query dimension, specify the query target, select a time range, and click Query. MSE supports two query dimensions:
Path: Enter the znode path to view all change events for that znode, the machines the events were pushed to, and the push status of each event.
Session ID: Enter the client session ID to view session details, change records, and push records associated with that client.
Read path query results
After you query by Path, the results split into two panels:
Change Event panel (left): Lists each znode change by configuration release time point. Click a configuration release time point to navigate to the corresponding entry in the right panel.
Changes and Push Events panel (right): Shows the full detail for each event.
For a change event: displays the event type of the change.
For a push event: displays the push time and the session ID of the client to which the event is pushed.
Read session ID query results
After you query by Session ID, the results display session information alongside the change records and push records for that client.
Parameter | Description |
Changed At | Timestamp when the znode changed. |
SessionId | Session ID of the client. |
Event | Operation type of the znode. |
Path | Path of the znode. |
Details | Click the |
icon to view change event details. Click the
icon to switch to the dimension query entry to query the push events during the specified period of time.