Help Center/ Application Operations Management/ User Guide (2.0) (Kuala Lumpur Region)/ Prometheus Monitoring/ Ingesting Middleware Metrics to AOM in VM Scenarios/ Ingesting Other Middleware Metrics to AOM
Updated on 2025-08-07 GMT+08:00
View PDF
Share

Ingesting Other Middleware Metrics to AOM

If existing middleware Exporters do not meet your requirements, install your own Exporter and create a collection task to monitor middleware metrics.

Prerequisites

Procedure

  1. Log in to the AOM 2.0 console.
  2. In the navigation pane on the left, ingest middleware metrics:

    • Choose Prometheus Monitoring > Instances. Click a Prometheus instance for ECS. On the instance details page, choose Access Center and then click the Other components card.

  3. On the displayed page, set parameters by referring to the following table.

    Table 1 Parameters for configuring a collection task

    Operation

    Parameter

    Description

    Select Instance

    Prometheus Instance

    Select a Prometheus instance for ECS to store collected data.

    A collection task is associated with the Prometheus instance to mark and classify collected data. If no Prometheus instance is available, create one.

    Set Plug-in

    OS

    Operating system of the host. Only Linux is supported.

    Collection Plug-in

    The default value is CUSTOM_EXPORTER.

    Plug-in Version

    Select a plug-in version. Plug-in versions that have not been released are dimmed and cannot be selected.

    Set Collection Task

    Collection Task Name

    Name of a collection task. Enter 1 to 50 characters starting with a letter. Only letters, digits, underscores (_), and hyphens (-) are allowed.

    Host

    Click Add Host. On the Add Host page, select the host for configuring the collection task and installing Exporter.

    • Search for and select a host by the host name, IP address, or Agent status.
    • You can click in the upper right corner to deselect the selected host.
    • Ensure that the UniAgent of the selected host is running. Otherwise, no data can be collected.

    Plug-in Collection Parameters

    Exporter Address: IP address and port number of the host where Exporter is installed. The format is "IP address:Port", for example, 10.0.0.1:9100

    Metric Dimension
    Click . In the displayed dialog box, select Built-in or Custom to add a metric dimension.
    • Metric dimension name:
      • Built-in metric dimensions: _app, _comp, and _env are available, which are used to identify applications, components, and environments, respectively.
      • Custom metric dimension: Enter a metric dimension name. Each name can contain 1 to 64 characters. Only letters, digits, and underscores (_) are allowed. Each name must start with a letter or underscore.

      For a host, each metric dimension name must be unique.

    • Metric dimension value: Enter the value of a metric dimension. This value can be duplicate but cannot be empty. Each value can contain 1 to 128 characters. The following characters are not allowed: &|><$;'!-()

    Up to 10 dimensions can be added. For example, if the dimension name is label1 and the dimension value is label2, label1:"label2" will be displayed.

    Advanced Settings

    Configure the following parameters:

    • Collection Period (s): O&M data collection period, in seconds. Options: 10s, 30s, and 60s (default).
    • Timeout Period (s): the maximum time allowed for executing a collection task, in seconds. Options: 10s, 30s, and 60s (default). The timeout period cannot exceed the collection period.
    • Executor: user who executes the collection task, that is, the user of the selected host. The default value is root. Currently, only the root user is supported.

  4. Click Create.
  5. The connected plug-in will be displayed on the Collection Tasks tab page of the plug-in card. Click the plug-in card. On the Collection Tasks tab page, click the target collection task to view its details.

    You can also perform the operations listed in the following table on the collection task.

    Table 2 Related operations

    Operation

    Description

    Checking a collection task

    Click a collection task to go to its details page.

    Starting or stopping a collection task

    Click the button in the Start/Stop column of a collection task to start or stop it.

    Searching for a collection task

    Set filter criteria or enter keywords to search for a collection task.

    Changing target hosts

    Click in the Operation column of the target collection task. On the displayed page, change target hosts.

    You can only change the target hosts for the collection tasks created using custom plug-ins.

    Sorting collection tasks

    Click in the Timeout Period or Collection Period column to sort collection tasks.

    Copying a collection task

    Click in the Operation column of a collection task. On the displayed page, modify parameters as required.

    Modifying a collection task

    Choose > Modify in the Operation column of the target collection task. On the displayed page, modify parameters as required.

    Deleting a collection task

    Locate a collection task and choose > Delete in the Operation column. On the displayed page, confirm the deletion.