Kentik SyntheticsAdminService API

openapi: 3.0.0
info:
  title: AI Advisor AiAdvisorDataService SyntheticsAdminService API
  description: '# Overview

    Provides programmatic access to AI Advisor.'
  version: v202511
  contact:
    name: Kentik API Engineering
    url: https://github.com/kentik/api-schema-public
security:
- email: []
  token: []
tags:
- name: SyntheticsAdminService
paths:
  /synthetics/v202309/agentAlerts:
    get:
      summary: List agent alert configurations
      description: Lists all agent alert configurations, optionally filtered by a list of agent ids.
      operationId: ListAgentAlerts
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309ListAgentAlertsResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: agentIds
        description: Optional list of agent ids to retrieve alert configurations for
        in: query
        required: false
        explode: true
        schema:
          type: array
          items:
            type: string
      tags:
      - SyntheticsAdminService
    post:
      summary: Create an agent alert configuration
      description: Creates a new agent alert configuration.
      operationId: CreateAgentAlert
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309CreateAgentAlertResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v202309CreateAgentAlertRequest'
        required: true
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/agentAlerts/{id}:
    get:
      summary: Get an agent alert configuration
      description: Retrieves an existing agent alert configuration.
      operationId: GetAgentAlert
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309GetAgentAlertResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
    delete:
      summary: Delete an agent alert configuration
      description: Deletes an existing agent alert configuration.
      operationId: DeleteAgentAlert
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309DeleteAgentAlertResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
    put:
      summary: Update an agent alert configuration
      description: Updates an existing agent alert configuration with the time threshold and notification channels provided.
      operationId: UpdateAgentAlert
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309UpdateAgentAlertResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyntheticsAdminServiceUpdateAgentAlertBody'
        required: true
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/agents:
    get:
      summary: List available agents
      description: Returns list of all synthetic agents available in the account.
      operationId: ListAgents
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309ListAgentsResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/agents/{agent.id}:
    put:
      summary: Update configuration of an agent
      description: Update configuration of a synthetic agent.
      operationId: UpdateAgent
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309UpdateAgentResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: agent.id
        description: Unique identifier of the agent
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyntheticsAdminServiceUpdateAgentBody'
        required: true
      tags:
      - SyntheticsAdminService
    get:
      summary: Get information about an agent
      description: Returns information about the requested synthetic agent.
      operationId: GetAgent
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309GetAgentResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: agent.id
        description: ID of the requested agent
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
    delete:
      summary: Delete an agent
      description: Deletes the requested agent. The deleted agent is removed from configuration of all tests.
      operationId: DeleteAgent
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309DeleteAgentResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: agent.id
        description: ID of the agent to be deleted
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/tests:
    get:
      summary: List all tests
      description: Returns a list of all configured active and paused synthetic tests.
      operationId: ListTests
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309ListTestsResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      tags:
      - SyntheticsAdminService
    post:
      summary: Create a test
      description: Create synthetic test based on configuration provided in the request.
      operationId: CreateTest
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309CreateTestResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/v202309CreateTestRequest'
        required: true
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/tests/{id}:
    get:
      summary: Get information about a test
      description: Returns configuration and status for the requested synthetic test.
      operationId: GetTest
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309GetTestResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: ID of requested test
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
    delete:
      summary: Delete a synthetic test.
      description: Deletes the synthetics test. All accumulated results for the test cease to be accessible.
      operationId: DeleteTest
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309DeleteTestResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: ID of the test to be deleted
        in: path
        required: true
        schema:
          type: string
      tags:
      - SyntheticsAdminService
    put:
      summary: Update configuration of a test
      description: Updates configuration of a synthetic test.
      operationId: UpdateTest
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309UpdateTestResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: Unique ID of the test
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyntheticsAdminServiceUpdateTestBody'
        required: true
      tags:
      - SyntheticsAdminService
  /synthetics/v202309/tests/{id}/status:
    put:
      summary: Update status of a synthetic test
      description: Update status of a synthetic test
      operationId: SetTestStatus
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v202309SetTestStatusResponse'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/rpcStatus'
      parameters:
      - name: id
        description: ID of the test which status is to be modified
        in: path
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SyntheticsAdminServiceSetTestStatusBody'
        required: true
      tags:
      - SyntheticsAdminService
components:
  schemas:
    v202309AlertingType:
      type: string
      enum:
      - ALERTING_TYPE_UNSPECIFIED
      - ALERTING_TYPE_AGENT
      - ALERTING_TYPE_GROUPED
      - ALERTING_TYPE_SUBTEST
      default: ALERTING_TYPE_UNSPECIFIED
      description: "- ALERTING_TYPE_UNSPECIFIED: Invalid value.\n - ALERTING_TYPE_AGENT: Per-Agent - Generates alerts based on individual metric thresholds (This can be noisy)\n - ALERTING_TYPE_GROUPED: Grouped - Reduces the number of alert notifications for upstream issues by forcing alert conditions to exist across multiple network paths\n - ALERTING_TYPE_SUBTEST: All metrics - Calculates health and alerts for the test as a whole"
      title: AlertingType
    v202309ActivationSettings:
      type: object
      properties:
        gracePeriod:
          type: string
          description: Period of healthy status in minutes within the time window not cancelling alarm activation
        timeUnit:
          type: string
          description: Time unit for specifying time window (m | h)
        timeWindow:
          type: string
          description: Time window for evaluating of test for alarm activation
        times:
          type: string
          description: Number of occurrences of unhealthy test status within the time window triggering alarm activation
      title: ActivationSettings
    v202309GetAgentAlertResponse:
      type: object
      properties:
        agentAlert:
          $ref: '#/components/schemas/v202309AgentAlert'
    v202309DeleteTestResponse:
      type: object
      title: DeleteTestResponse
    v202309DNSRecord:
      type: string
      enum:
      - DNS_RECORD_UNSPECIFIED
      - DNS_RECORD_A
      - DNS_RECORD_AAAA
      - DNS_RECORD_CNAME
      - DNS_RECORD_DNAME
      - DNS_RECORD_NS
      - DNS_RECORD_MX
      - DNS_RECORD_PTR
      - DNS_RECORD_SOA
      default: DNS_RECORD_UNSPECIFIED
      description: "- DNS_RECORD_UNSPECIFIED: Invalid value\n - DNS_RECORD_A: name to IPv4 address(es) mapping\n - DNS_RECORD_AAAA: name to IPv6 address(es) mapping\n - DNS_RECORD_CNAME: alternative resource name\n - DNS_RECORD_DNAME: alternative resource set name\n - DNS_RECORD_NS: domain to name server mapping\n - DNS_RECORD_MX: SMTP mail server record\n - DNS_RECORD_PTR: IPv4/6 address to name mapping\n - DNS_RECORD_SOA: domain meta-data"
      title: DNSRecord
    v202309Test:
      type: object
      properties:
        id:
          type: string
          description: Unique ID of the test
          readOnly: true
        name:
          type: string
          description: User selected name of the test
        type:
          type: string
          description: Type of the test
        status:
          $ref: '#/components/schemas/v202309TestStatus'
        settings:
          $ref: '#/components/schemas/v202309TestSettings'
        cdate:
          type: string
          format: date-time
          description: Creation timestamp (UTC)
          readOnly: true
        edate:
          type: string
          format: date-time
          description: Last modification timestamp (UTC)
          readOnly: true
        createdBy:
          $ref: '#/components/schemas/v202303UserInfo'
        lastUpdatedBy:
          $ref: '#/components/schemas/v202303UserInfo'
        labels:
          type: array
          items:
            type: string
          description: Set of labels associated with the test
      title: Test
    v202309CreateTestResponse:
      type: object
      properties:
        test:
          $ref: '#/components/schemas/v202309Test'
      title: CreateTestResponse
    v202309ListAgentAlertsResponse:
      type: object
      properties:
        agentAlerts:
          type: array
          items:
            $ref: '#/components/schemas/v202309AgentAlert'
    v202309GetAgentResponse:
      type: object
      properties:
        agent:
          $ref: '#/components/schemas/v202309Agent'
      title: GetAgentResponse
    v202309UpdateAgentAlertResponse:
      type: object
      properties:
        agentAlert:
          $ref: '#/components/schemas/v202309AgentAlert'
    v202309GroupedAlertSettings:
      type: object
      properties:
        default:
          $ref: '#/components/schemas/v202309GroupedAlertSetting'
        overrides:
          type: array
          items:
            $ref: '#/components/schemas/v202309GroupedAlertSetting'
          description: Overrides to default grouped alerting settings
      title: GroupedAlertSettings
    v202309CreateAgentAlertResponse:
      type: object
      properties:
        agentAlert:
          $ref: '#/components/schemas/v202309AgentAlert'
    v202309DeleteAgentAlertResponse:
      type: object
    v202309ListAgentsResponse:
      type: object
      properties:
        agents:
          type: array
          items:
            $ref: '#/components/schemas/v202309Agent'
          description: List of available agents
        invalidCount:
          type: integer
          format: int64
          description: Number of invalid entries encountered while collecting data
      title: ListAgentsResponse
    v202309ListTestsResponse:
      type: object
      properties:
        tests:
          type: array
          items:
            $ref: '#/components/schemas/v202309Test'
          description: List of configured active or paused tests
        invalidCount:
          type: integer
          format: int64
          description: Number of invalid entries encountered while collecting data
      title: ListTestsResponse
    v202309DnsTest:
      type: object
      properties:
        target:
          type: string
          description: Fully qualified DNS name to query
        timeout:
          type: integer
          format: int64
          description: '--- Deprecated: value is ignored. ---'
        recordType:
          $ref: '#/components/schemas/v202309DNSRecord'
        servers:
          type: array
          items:
            type: string
          description: List of IP addresses of DNS servers
        port:
          type: integer
          format: int64
          description: Target DNS server port
      title: DnsTest
    v202309IpTest:
      type: object
      properties:
        targets:
          type: array
          items:
            type: string
          description: List of IP addresses of targets
        useLocalIp:
          type: boolean
          description: Boolean value indicating whether to use local (private) IP address of the target agents
      title: IpTest
    v202309IPFamily:
      type: string
      enum:
      - IP_FAMILY_UNSPECIFIED
      - IP_FAMILY_V4
      - IP_FAMILY_V6
      - IP_FAMILY_DUAL
      default: IP_FAMILY_UNSPECIFIED
      description: "- IP_FAMILY_UNSPECIFIED: Invalid value.\n - IP_FAMILY_V4: IPv4 only\n - IP_FAMILY_V6: IPv6 only\n - IP_FAMILY_DUAL: IPv4 and IPv6 supported"
      title: IPFamily
    v202309TestThroughputSettings:
      type: object
      properties:
        port:
          type: integer
          format: int64
          description: Target port for TCP or UDP throughput task (the port the target server is listening on)
        omit:
          type: integer
          format: int64
          description: (optional) Number of seconds to omit from the start of the test
        duration:
          type: integer
          format: int64
          description: Duration of the test in seconds
        bandwidth:
          type: integer
          format: int64
          description: (optional) Target bandwidth in Mbps, if no bandwidth is specified, the test will measure the maximum bandwidth for TCP and 10Mbps for UDP
        protocol:
          type: string
          description: Transport protocol to use (tcp | udp)
      title: TestThroughputSettings
    v202309DisabledMetrics:
      type: object
      properties:
        pingLatency:
          type: boolean
        pingJitter:
          type: boolean
        pingPacketLoss:
          type: boolean
        httpLatency:
          type: boolean
        httpHeaders:
          type: boolean
        httpCodes:
          type: boolean
        httpCertExpiry:
          type: boolean
        transactionLatency:
          type: boolean
        dnsLatency:
          type: boolean
        dnsCodes:
          type: boolean
        dnsIps:
          type: boolean
        throughputBandwidth:
          type: boolean
    v202309UpdateAgentResponse:
      type: object
      properties:
        agent:
          $ref: '#/components/schemas/v202309Agent'
      title: UpdateAgentResponse
    v202309AlertingSettings:
      type: object
      properties:
        disableWarningNotifications:
          type: boolean
          description: Boolean indicating whether to disable warning-level alert notifications
        alertingType:
          $ref: '#/components/schemas/v202309AlertingType'
        groupedAlertSettings:
          $ref: '#/components/schemas/v202309GroupedAlertSettings'
      title: AlertingSettings
    v202309PageLoadTest:
      type: object
      properties:
        target:
          type: string
          description: HTTP or HTTPS URL to request
        timeout:
          type: integer
          format: int64
          description: HTTP transaction timeout (in milliseconds)
        headers:
          type: object
          additionalProperties:
            type: string
          description: Map of HTTP header values keyed by header names
        ignoreTlsErrors:
          type: boolean
          description: Boolean indicating whether to ignore TLS certificate verification errors
        cssSelectors:
          type: object
          additionalProperties:
            type: string
          description: Map of CSS selector values keyed by selector name
      title: PageLoadTest
    SyntheticsAdminServiceSetTestStatusBody:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/v202309TestStatus'
      title: SetTestStatusRequest
      required:
      - status
    v202309NetworkMeshTest:
      type: object
      properties:
        useLocalIp:
          type: boolean
          description: Boolean value indicating whether to use local (private) IP address of the target agents
      title: NetworkMeshTest
    v202309FlowTest:
      type: object
      properties:
        target:
          type: string
          description: Target ASN, CDN, Country, Region of City for autonomous test (type of value depends on flow test sub-type)
        targetRefreshIntervalMillis:
          type: integer
          format: int64
          description: Period (in milliseconds) for refreshing list of targets based on available flow data
        maxProviders:
          type: integer
          format: int64
          description: Maximum number of IP providers to track autonomously
        maxIpTargets:
          type: integer
          format: int64
          description: Maximum number of target IP addresses to select based flow data query
        type:
          type: string
          description: Autonomous test sub-type (asn | cdn | country | region | city)
        inetDirection:
          type: string
          description: Selection of address from flow data (src = source address in inbound flows | dst = destination addresses in outbound flows)
        direction:
          type: string
          description: Direction of flows to match target attribute for extraction of target addresses (src | dst)
      title: FlowTest
    v202309TestStatus:
      type: string
      enum:
      - TEST_STATUS_UNSPECIFIED
      - TEST_STATUS_ACTIVE
      - TEST_STATUS_PAUSED
      - TEST_STATUS_DELETED
      - TEST_STATUS_PREVIEW
      default: TEST_STATUS_UNSPECIFIED
      description: "- TEST_STATUS_UNSPECIFIED: Invalid value.\n - TEST_STATUS_ACTIVE: Test is active.\n - TEST_STATUS_PAUSED: Test is paused.\n - TEST_STATUS_DELETED: Test is deleted. Not user settable.\n - TEST_STATUS_PREVIEW: Test is preview"
      title: TestStatus
    v202309CreateTestRequest:
      type: object
      properties:
        test:
          $ref: '#/components/schemas/v202309Test'
      title: CreateTestRequest
      required:
      - test
    v202309TestTraceSettings:
      type: object
      properties:
        count:
          type: integer
          format: int64
          description: Number of probe packets to send in one iteration
        protocol:
          type: string
          description: Transport protocol to use (icmp | tcp | udp)
        port:
          type: integer
          format: int64
          description: Target port for TCP or UDP probes (ignored for ICMP)
        timeout:
          type: integer
          format: int64
          description: Timeout in milliseconds for execution of the task
        limit:
          type: integer
          format: int64
          description: Maximum number of hops to probe (i.e. maximum TTL)
        delay:
          type: number
          format: float
          description: Inter-probe delay in milliseconds
        dscp:
          type: integer
          format: int64
          description: DSCP code to be set in IP header of probe packets
        mtu:
          type: boolean
          description: Enable MTU in trace results
      title: TestTraceSettings
    v202309AgentTest:
      type: object
      properties:
        target:
          type: string
          description: ID of the target agent
        useLocalIp:
          type: boolean
          description: Boolean value indicating whether to use local (private) IP address of the target agent
        reciprocal:
          type: boolean
          description: Boolean value indicating whether to make the test bidirectional
      title: AgentTest
    rpcStatus:
      type: object
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
        details:
          type: array
          items:
            $ref: '#/components/schemas/protobufAny'
    v202309HealthSettings:
      type: object
      properties:
        latencyCritical:
          type: number
          format: float
          description: Threshold for ping response latency (in microseconds) to trigger critical alarm
        latencyWarning:
          type: number
          format: float
          description: Threshold for ping response latency (in microseconds) to trigger warning alarm
        packetLossCritical:
          type: number
          format: float
          description: Threshold for ping packet loss (in %) to trigger critical alarm
        packetLossWarning:
          type: number
          format: float
          description: Threshold for ping packet loss (in %) to trigger warning alarm
        jitterCritical:
          type: number
          format: float
          description: Threshold for ping jitter (in microseconds) to trigger critical alarm
        jitterWarning:
          type: number
          format: float
          description: Threshold for ping jitter (in microseconds) to trigger critical alarm
        httpLatencyCritical:
          type: number
          format: float
          description: Threshold for HTTP response latency (in microseconds) to trigger critical alarm
        httpLatencyWarning:
          type: number
          format: float
          description: Threshold for HTTP response latency (in microseconds) to trigger warning alarm
        httpValidCodes:
          type: array
          items:
            type: integer
            format: int64
          description: List of HTTP status codes indicating healthy state
        dnsValidCodes:
          type: array
          items:
            type: integer
            format: int64
          description: List of DNS status codes indicating healthy state
        latencyCriticalStddev:
          type: number
          format: float
          description: Threshold for standard deviation (in microseconds) of ping response latency to trigger critical alarm
        latencyWarningStddev:
          type: number
          format: float
          description: Threshold for standard deviation (in microseconds) of ping response latency to trigger warning alarm
        jitterCriticalStddev:
          type: number
          format: float
          description: Threshold for standard deviation of ping jitter (in microseconds) to trigger critical alarm
        jitterWarningStddev:
          type: number
          format: float
          description: Threshold for standard deviation of ping jitter (in microseconds) to trigger warning alarm
        httpLatencyCriticalStddev:
          type: number
          format: float
          description: Threshold for standard deviation of HTTP response latency (in microseconds) to trigger critical alarm
        httpLatencyWarningStddev:
          type: number
          format: float
          description: Threshold for standard deviation of HTTP response latency (in microseconds) to trigger warning alarm
        unhealthySubtestThreshold:
          type: integer
          format: int64
          description: Number of tasks (across all agents) that must report unhealthy status in order for alarm to be triggered
        activation:
          $ref: '#/components/schemas/v202309ActivationSettings'
        certExpiryWarning:
          type: integer
          format: int64
          description: Threshold for remaining validity of TLS certificate (in days) to trigger warning alarm
        certExpiryCritical:
          type: integer
          format: int64
          description: Threshold for remaining validity of TLS certificate (in days) to trigger critical alarm
        dnsValidIps:
          type: string
          description: Comma separated list of IP addresses expected to be received in response to DNS A or AAAA query
        dnsLatencyCritical:
          type: number
          format: float
          description: Threshold for DNS response latency (in microseconds) to trigger critical alarm
        dnsLatencyWarning:
          type: number
          format: float
          description: Threshold for DNS response latency (in microseconds) to trigger warning alarm
        dnsLatencyCriticalStddev:
          type: number
          format: float
          description: Threshold for standard deviation (in microseconds) of DNS response latency to trigger critical alarm
        dnsLatencyWarningStddev:
          type: number
          format: float
          description: Threshold for standard deviation (in microseconds) of DNS response latency to trigger warning alarm
        perAgentAlerting:
          type: boolean
          description: Boolean value indicating whether to use per-agent alerting
        disabledMetrics:
          $ref: '#/components/schemas/v202309DisabledMetrics'
        healthDisabled:
          type: boolean
          description: Disable all health evaluation for this test
        throughputCritical:
          type: number
          format: float
          description: Threshold for throughput bandwidth (in mbps) to trigger critical alarm
        throughputWarning:
          type: number
          format: float
          description: Threshold for throughput bandwidth (in mbps) to trigger warning alarm
        throughputCriticalStddev:
          type: number
          format: float
          description: Threshold for standard deviation (in mbps) of throughput bandwidth to trigger critical alarm
        throughputWarningStddev:
          type: number
          format: float
          description: Threshold for standard deviation (in mbps) of throughput bandwidth to trigger warning alarm
        disableAlerts:
          type: boolean
          description: Boolean value indicating whether to disable all alerts for this test
      title: HealthSettings
    v202309CreateAgentAlertRequest:
      type: object
 

# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/kentik/refs/heads/main/openapi/kentik-syntheticsadminservice-api-openapi.yml