# Agora Analytics data metrics (/en/realtime-media/im/reference/console/data-metrics)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

This page explains Chat-related metrics.

## Scale metrics [#scale-metrics]

### Total registered users [#total-registered-users]

The accumulated number of registered users under this project as of the current time. This number could decline if some UIDs are deleted.

### Daily new users [#daily-new-users]

The number of newly registered users under this project today (00:00 – current time).

### Daily active users (DAU) [#daily-active-users-dau]

The number of users who log in or send or receive messages today (00:00 – current time). A user connected through multiple devices is regarded as one active user.

### Monthly Max. DAU [#monthly-max-dau]

The highest number of DAU from 00:00 on the first day of this month to the current time.

### Total chat groups [#total-chat-groups]

The number of created chat groups under this project as of the current time (disbanded chat groups are excluded).

### Daily new chat groups [#daily-new-chat-groups]

The number of newly created chat groups under this project today (00:00 – current time).

### Daily disbanded chat groups [#daily-disbanded-chat-groups]

The number of disbanded chat groups under this project today (00:00 – current time).

### Daily active chat groups [#daily-active-chat-groups]

The number of chat groups that send uplink messages or receive downlink messages today (00:00 – current time).

### Total chat rooms [#total-chat-rooms]

The number of created chat rooms under this project as of the current time (disbanded chat rooms are excluded).

### Daily new chat rooms [#daily-new-chat-rooms]

The number of newly created chat rooms under this project today (00:00 – current time).

### Daily disbanded chat rooms [#daily-disbanded-chat-rooms]

The number of disbanded chat rooms under this project today (00:00 – current time).

### Daily active chat rooms [#daily-active-chat-rooms]

The number of chat rooms that send uplink messages or receive downlink messages today (00:00 – current time).

### Daily chat room PCU [#daily-chat-room-pcu]

The highest number of users connected to servers at the same time in chat rooms under this project today (00:00 - current time). Note that the displayed data has a 10-minute delay.

## Message count metrics [#message-count-metrics]

The following metrics apply to chat groups, chat rooms, and one-to-one chats, as well as all message types.

### Total dispatched messages [#total-dispatched-messages]

The number of messages dispatched by the Chat server as of yesterday.

### Total uplink messages [#total-uplink-messages]

The number of messages sent from clients to the Chat server as of yesterday.

### Total downlink messages [#total-downlink-messages]

The number of messages sent from the Chat server to online users as of yesterday.

### Total offline messages [#total-offline-messages]

The number of messages sent from the Chat server to offline users as of yesterday.

## End-user API metrics [#end-user-api-metrics]

### Metric type [#metric-type]

| Metric type           | Description                                                             |
| :-------------------- | :---------------------------------------------------------------------- |
| Manual login          | Users log in through a password or token.                               |
| Automatic login       | Users log in automatically through a persistent token.                  |
| Message sending       | Users send messages.                                                    |
| Friends management    | User operations such as adding or removing friends from their contacts. |
| User management       | User operations such as creating and updating a profile.                |
| Chat group management | User operations such as creating and deleting chat groups.              |
| Chat room management  | User operations such as creating and deleting chat rooms.               |

### Metric [#metric]

| Metric                        | Description                                                                                                                |
| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------- |
| Request attempts              | The total number of attempts to call the client SDK APIs.                                                                  |
| 1s/3s/5s request success rate | The number of successful calls of the client SDK API in 1s/3s/5s divided by the total number of effective call attempts ①. |
| Average request delay         | The sum of delay of client SDK API calls divided by the total number of successful calls.                                  |

① The total number of effective call attempts does not include invalid call attempts. A call attempt is considered as invalid if one of the following requirements is met:

* The username or password is empty or incorrect.
* The username is illegal.
* The password is invalid.
* The user cannot perform the operation without an admin permission.
* The user does not exist.
* The chat group does not exist.
* The user is not found in the chat group.

## Server API metrics [#server-api-metrics]

### Metric type [#metric-type-1]

| Metric type              | Description                                                                                         |
| :----------------------- | :-------------------------------------------------------------------------------------------------- |
| Token generation         | Retrieving a token that has the privilege of an administrator through the RESTful API.              |
| User system registration | User registration and retrieving, modifying, and deleting user information through the RESTful API. |
| File upload / download   | Uploading and downloading audio, image, and other files through the RESTful API.                    |
| Message sending          | Sending a message through the RESTful API.                                                          |
| Chat group management    | Functions such as creating and deleting chat groups through the RESTful API.                        |
| Chat room management     | Functions such as creating and deleting chat rooms through the RESTful API.                         |
| User attributes          | Functions such as setting and deleting user attributes through the RESTful API.                     |

### Metric [#metric-1]

| Metric                        | Description                                                                                                             |
| :---------------------------- | :---------------------------------------------------------------------------------------------------------------------- |
| Request attempts              | The total number of attempts to make RESTful API requests.                                                              |
| 1s/3s/5s request success rate | The number of successful RESTful API requests in 1s/3s/5s divided by the total number of RESTful API  request attempts. |
| Average request delay         | The sum of delay of all RESTful API requests divided by the total number of successful RESTful API requests.            |
