{
  "consumes": [
    "application/json"
  ],
  "definitions": {
    "LabelFilterLabelMatcher": {
      "description": "One matcher, and which of the alert's two label sets it applies to.",
      "properties": {
        "filter_target": {
          "$ref": "#/definitions/LabelMatcherFilterTarget"
        },
        "matcher": {
          "$ref": "#/definitions/commonPromQLMatcher"
        }
      },
      "type": "object"
    },
    "LabelFilterMatchStrategy": {
      "description": "How closely an alert's labels must correspond to the matchers.\n\n - SUBSET_MATCH: EQUAL matchers require the labels to contain all the given labels, but\nthe alert may carry more. NOT_EQUAL excludes an alert when the labels\nmatch any matcher.\n - EXACT_MATCH: EQUAL matchers require exactly the provided labels, no more or less.\nNOT_EQUAL excludes an alert only when every NOT_EQUAL matcher applies.",
      "enum": [
        "SUBSET_MATCH",
        "EXACT_MATCH"
      ],
      "type": "string"
    },
    "LabelMatcherFilterTarget": {
      "description": "The label set a matcher reads. An alert carries the labels of the\nsignal that fired (`SIGNAL`) and the labels of the monitor or SLO\nthat raised it (`MONITOR`); the two are matched independently.",
      "enum": [
        "MONITOR",
        "SIGNAL"
      ],
      "type": "string"
    },
    "MetricUsageQueryExecutionCountsByType": {
      "properties": {
        "explorer": {
          "format": "int32",
          "type": "integer"
        },
        "dashboard": {
          "format": "int32",
          "type": "integer"
        },
        "external": {
          "format": "int32",
          "type": "integer"
        }
      },
      "type": "object"
    },
    "MetricUsageReferenceCountsByType": {
      "properties": {
        "dashboards": {
          "format": "int32",
          "type": "integer"
        },
        "monitors": {
          "format": "int32",
          "type": "integer"
        },
        "recording_rules": {
          "format": "int32",
          "type": "integer"
        },
        "drop_rules": {
          "format": "int32",
          "type": "integer"
        },
        "aggregation_rules": {
          "format": "int32",
          "type": "integer"
        }
      },
      "type": "object"
    },
    "RuleEvaluationRuleType": {
      "enum": [
        "MONITOR",
        "RECORDING"
      ],
      "type": "string"
    },
    "apiError": {
      "properties": {
        "code": {
          "description": "An optional private error code whose values are undefined.",
          "format": "int32",
          "type": "integer"
        },
        "message": {
          "description": "An error message describing what went wrong.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "commonPromQLMatcher": {
      "properties": {
        "type": {
          "$ref": "#/definitions/commonPromQLMatcherType"
        },
        "name": {
          "description": "Prometheus label name for the matcher",
          "type": "string"
        },
        "value": {
          "description": "Prometheus label value for the matcher",
          "type": "string"
        }
      },
      "type": "object"
    },
    "commonPromQLMatcherType": {
      "enum": [
        "MatchEqual",
        "MatchRegexp",
        "MatchNotEqual",
        "MatchNotRegexp"
      ],
      "type": "string"
    },
    "configv1PageResult": {
      "properties": {
        "next_token": {
          "description": "An opaque page token that identifies the next page of items that the\nclient should request. An empty value indicates that there are no\nmore items to return.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "datav1FiringStatus": {
      "description": "Whether an alert is currently firing or has resolved.",
      "enum": [
        "RESOLVED",
        "FIRING"
      ],
      "type": "string"
    },
    "datav1LabelFilter": {
      "description": "A set of label matchers evaluated together as a single AND clause.",
      "properties": {
        "match_strategy": {
          "$ref": "#/definitions/LabelFilterMatchStrategy"
        },
        "label_matchers": {
          "description": "The matchers that make up this clause. An alert must satisfy all of\nthem. A filter with no matchers is ignored rather than matching\neverything.",
          "items": {
            "$ref": "#/definitions/LabelFilterLabelMatcher"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "datav1Severity": {
      "description": "The severity an alert fired at.",
      "enum": [
        "WARN",
        "CRITICAL"
      ],
      "type": "string"
    },
    "statev1ListMetricUsagesByLabelNameResponse": {
      "properties": {
        "page": {
          "$ref": "#/definitions/configv1PageResult"
        },
        "usages": {
          "items": {
            "$ref": "#/definitions/statev1MetricUsageByLabelName"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "statev1ListMetricUsagesByMetricNameResponse": {
      "properties": {
        "page": {
          "$ref": "#/definitions/configv1PageResult"
        },
        "usages": {
          "items": {
            "$ref": "#/definitions/statev1MetricUsageByMetricName"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "statev1ListMonitorStatusesRequest": {
      "properties": {
        "monitor_slugs": {
          "description": "Return only these monitors. When empty, returns every monitor with a firing\nalert that matches the other filters. A named monitor with no firing alert\nmatching the filters is returned as passing, even when it has firing alerts\nthe filters exclude. Slugs are not checked against existing monitors, so a\nslug that names no monitor is also returned as passing.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "collection_slugs": {
          "description": "Count only alerts from monitors owned by one of these collections.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "team_slugs": {
          "description": "Count only alerts from monitors owned by one of these teams.",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "label_filters": {
          "description": "Each LabelFilter is one AND clause; the clauses are OR'ed together.\nApplied to alerts before they roll up into monitor statuses, with the same\nsemantics as ListAlerts.",
          "items": {
            "$ref": "#/definitions/datav1LabelFilter"
          },
          "type": "array"
        },
        "severity": {
          "$ref": "#/definitions/datav1Severity"
        },
        "include_signals": {
          "description": "Include each monitor's firing signals.",
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "statev1ListMonitorStatusesResponse": {
      "properties": {
        "monitor_statuses": {
          "description": "One entry per monitor with at least one firing alert matching the filters,\nplus a passing entry for each of `monitor_slugs` that has none, ordered by\nmonitor slug. Other monitors are omitted.",
          "items": {
            "$ref": "#/definitions/statev1MonitorStatus"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "statev1ListRuleEvaluationsResponse": {
      "properties": {
        "page": {
          "$ref": "#/definitions/configv1PageResult"
        },
        "rule_evaluations": {
          "items": {
            "$ref": "#/definitions/statev1RuleEvaluation"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "statev1MetricUsage": {
      "properties": {
        "total_references": {
          "format": "int32",
          "type": "integer"
        },
        "total_query_executions": {
          "format": "int32",
          "type": "integer"
        },
        "total_unique_users": {
          "format": "int32",
          "type": "integer"
        },
        "utility_score": {
          "format": "double",
          "type": "number"
        },
        "reference_counts_by_type": {
          "$ref": "#/definitions/MetricUsageReferenceCountsByType"
        },
        "query_execution_counts_by_type": {
          "$ref": "#/definitions/MetricUsageQueryExecutionCountsByType"
        }
      },
      "type": "object"
    },
    "statev1MetricUsageByLabelName": {
      "properties": {
        "label_name": {
          "type": "string"
        },
        "usage": {
          "$ref": "#/definitions/statev1MetricUsage"
        },
        "total_unique_values": {
          "format": "int32",
          "type": "integer"
        },
        "dpps": {
          "format": "double",
          "type": "number"
        },
        "percent_of_series_with_label_name": {
          "description": "Percent of persisted series observed to have the label name.\nReturns in format: [0.0, 100.0]",
          "format": "double",
          "type": "number"
        }
      },
      "type": "object"
    },
    "statev1MetricUsageByMetricName": {
      "properties": {
        "metric_name": {
          "type": "string"
        },
        "usage": {
          "$ref": "#/definitions/statev1MetricUsage"
        },
        "dpps": {
          "format": "double",
          "type": "number"
        }
      },
      "type": "object"
    },
    "statev1MonitorStatus": {
      "description": "The state of one monitor under the request's filters, rolled up from its\nfiring alerts that match them. A monitor whose firing alerts the filters all\nexclude is reported as passing. A passing monitor has a `RESOLVED` firing\nstatus, no severity and no signals.",
      "properties": {
        "monitor_slug": {
          "description": "The slug of the monitor.",
          "type": "string"
        },
        "firing_status": {
          "$ref": "#/definitions/datav1FiringStatus"
        },
        "muted": {
          "description": "True when every matching firing alert is muted.",
          "type": "boolean"
        },
        "severity": {
          "$ref": "#/definitions/datav1Severity"
        },
        "signals": {
          "description": "The monitor's firing signals that match the filters, ordered by their\nlabels. Set only with `include_signals`.",
          "items": {
            "$ref": "#/definitions/statev1SignalStatus"
          },
          "type": "array"
        }
      },
      "type": "object"
    },
    "statev1RuleEvaluation": {
      "properties": {
        "rule_slug": {
          "description": "Unique identifier of the rule.",
          "type": "string"
        },
        "rule_type": {
          "$ref": "#/definitions/RuleEvaluationRuleType"
        },
        "detected_at": {
          "description": "Timestamp when the rule evaluation issues are detected.\nRule evaluations issues are aggregated over last 5 minute leading up to detected_at.",
          "format": "date-time",
          "type": "string"
        },
        "count": {
          "description": "The number of rule evaluation issues occurred over last 5 minutes.",
          "format": "int32",
          "type": "integer"
        },
        "message": {
          "description": "Detailed message related to rule evaluation issue. See \"Admin \u003e Evaluation failures\" in the Palo Alto Networks documentation for more information.",
          "type": "string"
        },
        "severity": {
          "$ref": "#/definitions/statev1RuleEvaluationSeverity"
        }
      },
      "type": "object"
    },
    "statev1RuleEvaluationSeverity": {
      "description": "Severity of the rule evaluation issue.\n\n - SEVERITY_ERROR: A hard evaluation failure.\n - SEVERITY_WARNING: A non-fatal warning; the evaluation succeeded but something needs attention.",
      "enum": [
        "SEVERITY_ERROR",
        "SEVERITY_WARNING"
      ],
      "type": "string"
    },
    "statev1SeverityStatus": {
      "description": "The firing alert of one severity of a signal.",
      "properties": {
        "severity": {
          "$ref": "#/definitions/datav1Severity"
        },
        "muted": {
          "description": "Whether notifications for the alert are muted.",
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "statev1SignalStatus": {
      "description": "One firing signal of a monitor.",
      "properties": {
        "signal_labels": {
          "additionalProperties": {
            "type": "string"
          },
          "description": "The labels of the signal.",
          "type": "object"
        },
        "severities": {
          "description": "The signal's firing severities, most severe first.",
          "items": {
            "$ref": "#/definitions/statev1SeverityStatus"
          },
          "type": "array"
        }
      },
      "type": "object"
    }
  },
  "info": {
    "description": "\nThe State API provides HTTP/JSON REST endpoints for accessing the runtime state\nof the Chronosphere system.\n\nUse this link to download the raw Swagger specification:\n\u003ca href=\"/api/v1/state/swagger.json\"\u003e/api/v1/state/swagger.json\u003c/a\u003e\n",
    "title": "State V1 API",
    "version": "v1"
  },
  "paths": {
    "/api/v1/state/metric-usages-by-label-name": {
      "get": {
        "operationId": "ListMetricUsagesByLabelName",
        "parameters": [
          {
            "description": "Sets the preferred number of items to return per page. If set to `0`, the\nserver will use its default value. Regardless of the value specified, clients\nmust never assume how many items will be returned.",
            "format": "int64",
            "in": "query",
            "name": "page.max_size",
            "type": "integer"
          },
          {
            "description": "An opaque page token that identifies which page the client should request.\nAn empty value indicates the first page.",
            "in": "query",
            "name": "page.token",
            "type": "string"
          },
          {
            "in": "query",
            "name": "order.ascending",
            "type": "boolean"
          },
          {
            "enum": [
              "VALUABLE",
              "DPPS",
              "UTILITY",
              "REFERENCES",
              "EXECUTIONS",
              "UNIQUE_VALUES",
              "UNIQUE_USERS"
            ],
            "in": "query",
            "name": "order.by",
            "type": "string"
          },
          {
            "description": "Controls the time range over which query executions are included in usages. Defaults to `2592000` (30 days).",
            "format": "int32",
            "in": "query",
            "name": "lookback_secs",
            "type": "integer"
          },
          {
            "description": "Glob match string for filtering results by label name.",
            "in": "query",
            "name": "label_name_glob",
            "type": "string"
          },
          {
            "description": "If `true`, responses include the fields `reference_counts_by_type` and `query_execution_counts_by_type`. If `false`, these fields are returned empty.",
            "in": "query",
            "name": "include_counts_by_type",
            "type": "boolean"
          }
        ],
        "responses": {
          "200": {
            "description": "A successful response.",
            "schema": {
              "$ref": "#/definitions/statev1ListMetricUsagesByLabelNameResponse"
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "schema": {
              "$ref": "#/definitions/apiError"
            }
          }
        },
        "tags": [
          "MetricUsagesByLabelName"
        ]
      }
    },
    "/api/v1/state/metric-usages-by-metric-name": {
      "get": {
        "operationId": "ListMetricUsagesByMetricName",
        "parameters": [
          {
            "description": "Sets the preferred number of items to return per page. If set to `0`, the\nserver will use its default value. Regardless of the value specified, clients\nmust never assume how many items will be returned.",
            "format": "int64",
            "in": "query",
            "name": "page.max_size",
            "type": "integer"
          },
          {
            "description": "An opaque page token that identifies which page the client should request.\nAn empty value indicates the first page.",
            "in": "query",
            "name": "page.token",
            "type": "string"
          },
          {
            "in": "query",
            "name": "order.ascending",
            "type": "boolean"
          },
          {
            "enum": [
              "VALUABLE",
              "DPPS",
              "UTILITY",
              "REFERENCES",
              "EXECUTIONS",
              "UNIQUE_VALUES",
              "UNIQUE_USERS"
            ],
            "in": "query",
            "name": "order.by",
            "type": "string"
          },
          {
            "description": "Controls the time range over which query executions are included in usages. Defaults to `2592000` (30 days).",
            "format": "int32",
            "in": "query",
            "name": "lookback_secs",
            "type": "integer"
          },
          {
            "description": "Glob match string for filtering results by metric name.",
            "in": "query",
            "name": "metric_name_glob",
            "type": "string"
          },
          {
            "description": "If `true`, responses include the fields `reference_counts_by_type` and `query_execution_counts_by_type`. If `false`, these fields are returned empty.",
            "in": "query",
            "name": "include_counts_by_type",
            "type": "boolean"
          }
        ],
        "responses": {
          "200": {
            "description": "A successful response.",
            "schema": {
              "$ref": "#/definitions/statev1ListMetricUsagesByMetricNameResponse"
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "schema": {
              "$ref": "#/definitions/apiError"
            }
          }
        },
        "tags": [
          "MetricUsagesByMetricName"
        ]
      }
    },
    "/api/v1/state/monitor-statuses": {
      "post": {
        "description": "Lists monitors that have at least one firing alert matching the request's\nfilters, and how they are firing, plus each requested monitor that is\npassing under those filters. A read served by POST, because its label\nfilters cannot be expressed as query parameters.",
        "operationId": "ListMonitorStatuses",
        "parameters": [
          {
            "in": "body",
            "name": "body",
            "required": true,
            "schema": {
              "$ref": "#/definitions/statev1ListMonitorStatusesRequest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "A successful response.",
            "schema": {
              "$ref": "#/definitions/statev1ListMonitorStatusesResponse"
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "schema": {
              "$ref": "#/definitions/apiError"
            }
          }
        },
        "tags": [
          "MonitorStatuses"
        ]
      }
    },
    "/api/v1/state/rule-evaluations": {
      "get": {
        "operationId": "ListRuleEvaluations",
        "parameters": [
          {
            "description": "Sets the preferred number of items to return per page. If set to `0`, the\nserver will use its default value. Regardless of the value specified, clients\nmust never assume how many items will be returned.",
            "format": "int64",
            "in": "query",
            "name": "page.max_size",
            "type": "integer"
          },
          {
            "description": "An opaque page token that identifies which page the client should request.\nAn empty value indicates the first page.",
            "in": "query",
            "name": "page.token",
            "type": "string"
          },
          {
            "description": "When false (default), only failures are returned. Set true to also include non-fatal warnings.",
            "in": "query",
            "name": "include_warnings",
            "type": "boolean"
          }
        ],
        "responses": {
          "200": {
            "description": "A successful response.",
            "schema": {
              "$ref": "#/definitions/statev1ListRuleEvaluationsResponse"
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "schema": {
              "$ref": "#/definitions/apiError"
            }
          }
        },
        "tags": [
          "RuleEvaluations"
        ]
      }
    }
  },
  "produces": [
    "application/json"
  ],
  "swagger": "2.0",
  "tags": [
    {
      "name": "StateV1"
    }
  ]
}