Console
    Start free

    MCP Tools Reference: monitoring.googleapis.com

    Tool: get_alert

    Use this as the primary tool to get information about a specific alert. An alert is the representation of a violation of an alert policy. This is useful for understanding the details of a specific alert.

    The following sample demonstrate how to use curl to invoke the get_alert MCP tool.

    Curl Request 
      
curl  
--location  
 'https://monitoring.googleapis.com/mcp' 
  
 \ 
--header  
 'content-type: application/json' 
  
 \ 
--header  
 'accept: application/json, text/event-stream' 
  
 \ 
--data  
 '{ 
 "method": "tools/call", 
 "params": { 
 "name": "get_alert", 
 "arguments": { 
 // provide these details according to the tool' 
s  
MCP  
specification  
 } 
  
 } 
,  
 "jsonrpc" 
:  
 "2.0" 
,  
 "id" 
:  
 1 
 } 
 '

    Input Schema

    The GetAlert request.

    GetAlertRequest

    JSON representation 
     { 
 "name" 
 : 
 string 
 }
    Fields
    name

    string

    Required. The name of the alert.

    The format is:

     projects/[PROJECT_ID_OR_NUMBER]/alerts/[ALERT_ID]

    The [ALERT_ID] is a system-assigned unique identifier for the alert.

    Output Schema

    An alert is the representation of a violation of an alert policy. It is a read-only resource that cannot be modified by the accompanied API.

    Alert

    JSON representation 
     { 
 "name" 
 : 
 string 
 , 
 "state" 
 : 
 enum ( State 
) 
 , 
 "openTime" 
 : 
 string 
 , 
 "closeTime" 
 : 
 string 
 , 
 "resource" 
 : 
 { 
 object (  MonitoredResource 
 
) 
 } 
 , 
 "metadata" 
 : 
 { 
 object (  MonitoredResourceMetadata 
 
) 
 } 
 , 
 "metric" 
 : 
 { 
 object (  Metric 
 
) 
 } 
 , 
 "log" 
 : 
 { 
 object (  LogMetadata 
 
) 
 } 
 , 
 "policy" 
 : 
 { 
 object (  PolicySnapshot 
 
) 
 } 
 }
    Fields
    name

    string

    Identifier. The name of the alert.

    The format is:

     projects/[PROJECT_ID_OR_NUMBER]/alerts/[ALERT_ID]

    The [ALERT_ID] is a system-assigned unique identifier for the alert.
    state

    enum ( State )

    Output only. The current state of the alert.
    openTime

    string ( Timestamp format)

    The time when the alert was opened.

    Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .
    closeTime

    string ( Timestamp format)

    The time when the alert was closed.

    Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30" .
    resource

    object ( MonitoredResource )

    The monitored resource type and any monitored resource labels preserved from the incident's generating condition.
    metadata

    object ( MonitoredResourceMetadata )

    The metadata of the monitored resource.
    metric

    object ( Metric )

    The metric type and any metric labels preserved from the incident's generating condition.
    log

    object ( LogMetadata )

    The log information associated with the alert. This field is only populated for log-based alerts.
    policy

    object ( PolicySnapshot )

    The snapshot of the alert policy that generated this alert.

    Timestamp

    JSON representation 
     { 
 "seconds" 
 : 
 string 
 , 
 "nanos" 
 : 
 integer 
 }
    Fields
    seconds

    string ( int64 format)

    Represents seconds of UTC time since Unix epoch 1970-01-01T00:00:00Z. Must be between -62135596800 and 253402300799 inclusive (which corresponds to 0001-01-01T00:00:00Z to 9999-12-31T23:59:59Z).
    nanos

    integer

    Non-negative fractions of a second at nanosecond resolution. This field is the nanosecond portion of the duration, not an alternative to seconds. Negative second values with fractions must still have non-negative nanos values that count forward in time. Must be between 0 and 999,999,999 inclusive.

    MonitoredResource

    JSON representation 
     { 
 "type" 
 : 
 string 
 , 
 "labels" 
 : 
 { 
 string 
 : 
 string 
 , 
 ... 
 } 
 }
    Fields
    type

    string

    Required. The monitored resource type. This field must match the type field of a MonitoredResourceDescriptor object. For example, the type of a Compute Engine VM instance is gce_instance . For a list of types, see Monitoring resource types and Logging resource types .
    labels

    map (key: string, value: string)

    Required. Values for all of the labels listed in the associated monitored resource descriptor. For example, Compute Engine VM instances use the labels "project_id" , "instance_id" , and "zone" .

    An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

    LabelsEntry

    JSON representation 
     { 
 "key" 
 : 
 string 
 , 
 "value" 
 : 
 string 
 }
    Fields
    key

    string

    value

    string

    MonitoredResourceMetadata

    JSON representation 
     { 
 "systemLabels" 
 : 
 { 
 object 
 } 
 , 
 "userLabels" 
 : 
 { 
 string 
 : 
 string 
 , 
 ... 
 } 
 }
    Fields
    systemLabels

    object ( Struct format)

    Output only. Values for predefined system metadata labels. System labels are a kind of metadata extracted by Google, including "machine_image", "vpc", "subnet_id", "security_group", "name", etc. System label values can be only strings, Boolean values, or a list of strings. For example:

     { "name": "my-test-instance",
  "security_group": ["a", "b", "c"],
  "spot_instance": false }
    userLabels

    map (key: string, value: string)

    Output only. A map of user-defined metadata labels.

    An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

    Struct

    JSON representation 
     { 
 "fields" 
 : 
 { 
 string 
 : 
 value 
 , 
 ... 
 } 
 }
    Fields
    fields

    map (key: string, value: value ( Value format))

    Unordered map of dynamically typed values.

    An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

    FieldsEntry

    JSON representation 
     { 
 "key" 
 : 
 string 
 , 
 "value" 
 : 
 value 
 }
    Fields
    key

    string

    value

    value ( Value format)

    Value

    JSON representation 
     { 
 // Union field kind 
can be only one of the following: 
 "nullValue" 
 : 
 null 
 , 
 "numberValue" 
 : 
 number 
 , 
 "stringValue" 
 : 
 string 
 , 
 "boolValue" 
 : 
 boolean 
 , 
 "structValue" 
 : 
 { 
 object 
 } 
 , 
 "listValue" 
 : 
 array 
 // End of list of possible types for union field kind 
. 
 }
    Fields
    Union field kind . The kind of value. kind can be only one of the following:
    nullValue

    null

    Represents a null value.

    numberValue

    number

    Represents a double value.

    stringValue

    string

    Represents a string value.

    boolValue

    boolean

    Represents a boolean value.

    structValue

    object ( Struct format)

    Represents a structured value.

    listValue

    array ( ListValue format)

    Represents a repeated Value .

    ListValue

    JSON representation 
     { 
 "values" 
 : 
 [ 
 value 
 ] 
 }
    Fields
    values[]

    value ( Value format)

    Repeated field of dynamically typed values.

    UserLabelsEntry

    JSON representation 
     { 
 "key" 
 : 
 string 
 , 
 "value" 
 : 
 string 
 }
    Fields
    key

    string

    value

    string

    Metric

    JSON representation 
     { 
 "type" 
 : 
 string 
 , 
 "labels" 
 : 
 { 
 string 
 : 
 string 
 , 
 ... 
 } 
 }
    Fields
    type

    string

    An existing metric type, see google.api.MetricDescriptor . For example, custom.googleapis.com/invoice/paid/amount .
    labels

    map (key: string, value: string)

    The set of label values that uniquely identify this metric. All labels listed in the MetricDescriptor must be assigned values.

    An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

    LabelsEntry

    JSON representation 
     { 
 "key" 
 : 
 string 
 , 
 "value" 
 : 
 string 
 }
    Fields
    key

    string

    value

    string

    LogMetadata

    JSON representation 
     { 
 "extractedLabels" 
 : 
 { 
 string 
 : 
 string 
 , 
 ... 
 } 
 }
    Fields
    extractedLabels

    map (key: string, value: string)

    The labels extracted from the log.

    An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

    ExtractedLabelsEntry

    JSON representation 
     { 
 "key" 
 : 
 string 
 , 
 "value" 
 : 
 string 
 }
    Fields
    key

    string

    value

    string

    PolicySnapshot

    JSON representation 
     { 
 "name" 
 : 
 string 
 , 
 "displayName" 
 : 
 string 
 , 
 "severity" 
 : 
 enum ( Severity 
) 
 , 
 "userLabels" 
 : 
 { 
 string 
 : 
 string 
 , 
 ... 
 } 
 }
    Fields
    name

    string

    The name of the alert policy resource. In the form of "projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]".
    displayName

    string

    The display name of the alert policy.
    severity

    enum ( Severity )

    The severity of the alert policy.
    userLabels

    map (key: string, value: string)

    The user labels for the alert policy.

    An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

    UserLabelsEntry

    JSON representation 
     { 
 "key" 
 : 
 string 
 , 
 "value" 
 : 
 string 
 }
    Fields
    key

    string

    value

    string

    Tool Annotations

    Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌
    Create a Mobile Website
    View Site in Mobile | Classic
    Share by: