Selecting a Resource for a Query

• Console
• CLI
• API

• This section describes how to select a resource on the Metrics Explorer page by selecting a resource-specific dimension. For alarm query edits, see Creating a Basic Alarm.

  1. Create a basic query on the Metrics Explorer page.
  2. If the query isn't open, open it by selecting Edit queries.
  3. To select a resource by using Basic mode (default), provide the following information.

     Additional or other dimension fields appear for some metric namespaces. For example, a deployment type field appears for the oci_autonomous_database metric namespace. See the service-specific documentation for details.

     • Dimension name: A qualifier specified in the metric definition. For example, the dimension resourceId is specified in the metric definition for CpuUtilization.

       To select a specific resource within the selected compartment, filter results by a resource-specific dimension, such as resourceDisplayName.

       Note
       
       

       Long lists of dimensions are trimmed.

       • To view dimensions by name, type one or more characters in the box. A refreshed (trimmed) list shows matching dimension names.
       • To retrieve all dimensions for a metric, see Listing Metric Definitions.
     • Dimension value: The value that you want to use for the specified dimension, for example, the resource identifier for an instance.
     • Additional dimension: Adds another name-value pair for a dimension.
  4. To select a resource by updating the MQL expression, follow these steps:
     1. Select Advanced mode.
     2. Edit the text in the Query code editor box.
  5. Select Update Chart.

• Use the oci monitoring metric-data summarize-metrics-data command and required parameters to query metric data. Use the --query-text parameter to select resource-specific dimensions (part of the MQL expression).

  Command

  CopyTry It

  oci monitoring metric-data summarize-metrics-data --query-text <mql_expression> [...]

  For a complete list of parameters and values for CLI commands, see the Command Line Reference for Monitoring.

• Run the SummarizeMetricsData operation to query metric data. Use the query attribute to select resource-specific dimensions (part of the MQL expression). For an example, see SummarizeMetricsDataDetails.