Metrics

List and Create Metrics.

Metric name format: The following are acceptable formats for a metric name:

  • Metric names should not contain a dot (.), instead use an underscore (_) between the words
  • system.cpu.usage is not valid
  • system_cpu_usage is valid
  • A metric name can have a maximum of ten underscores “_”. A metric name cannot start or end with an underscore.
  • A metric name can contain numeric values (0-9), but cannot start with a numeric value.
  • A metric name should be case-insensitive.
  • The length of the metric name should be less than or equal to 255, including underscores..

Note: To use this API, you need to have the MONITORS_VIEW permissions assigned.

Search metrics within tenant.

  • Examples:
    • https://{{server}}/api/v2/tenants/{{tenantId}}/metrics?queryString=scope:client
    • https://{{server}}/api/v2/tenants/{{tenantId}}/metrics?queryString=metricName:esx_problem_vmfs_heartbeat_timedout
    • https://{{server}}/api/v2/tenants/{{tenantId}}/metrics?queryString=groupName:vmware_vsan_host_net_rxPackets

Path Parameters

  • tenantIdstringrequired

    Describes clientId or mspId of the tenant

Query Parameters

  • queryStringstring

    The query string to prepare query

  • metricNamestring

    Filter on metric name

  • groupNamestring

    Filter on metric group name

  • displayNamestring

    Filter on metric display name

  • scopestring

    Filter metrics within scope. e.g. partner scope lists only partner scoped metrics.'global' scope lists metrics visible to all.

    Enum:
    clientpartnerglobalservice provider

Responses

  • resultsarray

  • totalResultsnumber

  • pageNonumber

  • pageSizenumber

  • totalPagesnumber

  • sortOrderstring

  • sortBystring

Loading Examples...

Note: To use this API, you need to have the METRICS_MANAGE, MONITORS_CREATE and MONITORS_EDIT permissions assigned.

Create new custom metric.

Path Parameters

  • tenantIdstringrequired

    Describes clientId or mspId of the tenant

Request Body

application/json

  • metricNamestring

  • groupNamestring

  • typestring

  • resourceTypestring

  • displayNamestring

  • unitstring

  • displayUnitstring

  • factorinteger

  • unitLabelstring

  • descriptionstring

  • consolFuncstring

  • displayByComponentboolean

  • displayOrderinteger

  • topMetricboolean

  • adapterTypestring

Loading Examples...

Responses

Loading Examples...

Note: To use this API, you need to have the METRICS_MANAGE, MONITORS_CREATE and MONITORS_EDIT permissions assigned.

Update a basic metric details by metric name

Path Parameters

  • tenantIdstringrequired

    Describes clientId or mspId of the tenant

Request Body

application/json

  • metricNamestring

  • metricSourcestring

  • displayNamestring

  • descriptionstring

  • unitstring

  • unitLabelstring

  • groupNamestring

  • factorinteger

  • consolFuncstring

  • displayByComponentboolean

  • displayOrderinteger

  • topMetricboolean

  • timeSeriesboolean

  • warnRepeatCountinteger

  • criticalRepeatCountinteger

  • recommendedinteger

  • useExpressionboolean

  • unitConversionFactorinteger

  • statusstring

    Enum:
    activedelete-pending
  • typestring

  • resourceTypestring

Loading Examples...

Responses

  • metricNamestring

  • metricSourcestring

  • displayNamestring

  • descriptionstring

  • unitstring

  • unitLabelstring

  • groupNamestring

  • factorinteger

  • consolFuncstring

  • displayByComponentboolean

  • displayOrderinteger

  • topMetricboolean

  • timeSeriesboolean

  • warnRepeatCountinteger

  • criticalRepeatCountinteger

  • recommendedinteger

  • useExpressionboolean

  • unitConversionFactorinteger

  • statusstring

    Enum:
    activedelete-pending
  • typestring

  • resourceTypestring

Loading Examples...