1. Packages
  2. Grafana Cloud
  3. API Docs
  4. SyntheticMonitoringProbe
Grafana v0.5.1 published on Wednesday, Jun 12, 2024 by pulumiverse

grafana.SyntheticMonitoringProbe

Explore with Pulumi AI

grafana logo
Grafana v0.5.1 published on Wednesday, Jun 12, 2024 by pulumiverse

    Besides the public probes run by Grafana Labs, you can also install your own private probes. These are only accessible to you and only write data to your Grafana Cloud account. Private probes are instances of the open source Grafana Synthetic Monitoring Agent.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as grafana from "@pulumiverse/grafana";
    
    const main = new grafana.SyntheticMonitoringProbe("main", {
        labels: {
            type: "mountain",
        },
        latitude: 27.98606,
        longitude: 86.92262,
        region: "APAC",
    });
    
    import pulumi
    import pulumiverse_grafana as grafana
    
    main = grafana.SyntheticMonitoringProbe("main",
        labels={
            "type": "mountain",
        },
        latitude=27.98606,
        longitude=86.92262,
        region="APAC")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    	"github.com/pulumiverse/pulumi-grafana/sdk/go/grafana"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := grafana.NewSyntheticMonitoringProbe(ctx, "main", &grafana.SyntheticMonitoringProbeArgs{
    			Labels: pulumi.StringMap{
    				"type": pulumi.String("mountain"),
    			},
    			Latitude:  pulumi.Float64(27.98606),
    			Longitude: pulumi.Float64(86.92262),
    			Region:    pulumi.String("APAC"),
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Grafana = Pulumiverse.Grafana;
    
    return await Deployment.RunAsync(() => 
    {
        var main = new Grafana.SyntheticMonitoringProbe("main", new()
        {
            Labels = 
            {
                { "type", "mountain" },
            },
            Latitude = 27.98606,
            Longitude = 86.92262,
            Region = "APAC",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.grafana.SyntheticMonitoringProbe;
    import com.pulumi.grafana.SyntheticMonitoringProbeArgs;
    import java.util.List;
    import java.util.ArrayList;
    import java.util.Map;
    import java.io.File;
    import java.nio.file.Files;
    import java.nio.file.Paths;
    
    public class App {
        public static void main(String[] args) {
            Pulumi.run(App::stack);
        }
    
        public static void stack(Context ctx) {
            var main = new SyntheticMonitoringProbe("main", SyntheticMonitoringProbeArgs.builder()        
                .labels(Map.of("type", "mountain"))
                .latitude(27.98606)
                .longitude(86.92262)
                .region("APAC")
                .build());
    
        }
    }
    
    resources:
      main:
        type: grafana:SyntheticMonitoringProbe
        properties:
          labels:
            type: mountain
          latitude: 27.98606
          longitude: 86.92262
          region: APAC
    

    Create SyntheticMonitoringProbe Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new SyntheticMonitoringProbe(name: string, args: SyntheticMonitoringProbeArgs, opts?: CustomResourceOptions);
    @overload
    def SyntheticMonitoringProbe(resource_name: str,
                                 args: SyntheticMonitoringProbeArgs,
                                 opts: Optional[ResourceOptions] = None)
    
    @overload
    def SyntheticMonitoringProbe(resource_name: str,
                                 opts: Optional[ResourceOptions] = None,
                                 latitude: Optional[float] = None,
                                 longitude: Optional[float] = None,
                                 region: Optional[str] = None,
                                 labels: Optional[Mapping[str, str]] = None,
                                 name: Optional[str] = None,
                                 public: Optional[bool] = None)
    func NewSyntheticMonitoringProbe(ctx *Context, name string, args SyntheticMonitoringProbeArgs, opts ...ResourceOption) (*SyntheticMonitoringProbe, error)
    public SyntheticMonitoringProbe(string name, SyntheticMonitoringProbeArgs args, CustomResourceOptions? opts = null)
    public SyntheticMonitoringProbe(String name, SyntheticMonitoringProbeArgs args)
    public SyntheticMonitoringProbe(String name, SyntheticMonitoringProbeArgs args, CustomResourceOptions options)
    
    type: grafana:SyntheticMonitoringProbe
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args SyntheticMonitoringProbeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args SyntheticMonitoringProbeArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args SyntheticMonitoringProbeArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args SyntheticMonitoringProbeArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args SyntheticMonitoringProbeArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var syntheticMonitoringProbeResource = new Grafana.SyntheticMonitoringProbe("syntheticMonitoringProbeResource", new()
    {
        Latitude = 0,
        Longitude = 0,
        Region = "string",
        Labels = 
        {
            { "string", "string" },
        },
        Name = "string",
        Public = false,
    });
    
    example, err := grafana.NewSyntheticMonitoringProbe(ctx, "syntheticMonitoringProbeResource", &grafana.SyntheticMonitoringProbeArgs{
    	Latitude:  pulumi.Float64(0),
    	Longitude: pulumi.Float64(0),
    	Region:    pulumi.String("string"),
    	Labels: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	Name:   pulumi.String("string"),
    	Public: pulumi.Bool(false),
    })
    
    var syntheticMonitoringProbeResource = new SyntheticMonitoringProbe("syntheticMonitoringProbeResource", SyntheticMonitoringProbeArgs.builder()
        .latitude(0)
        .longitude(0)
        .region("string")
        .labels(Map.of("string", "string"))
        .name("string")
        .public_(false)
        .build());
    
    synthetic_monitoring_probe_resource = grafana.SyntheticMonitoringProbe("syntheticMonitoringProbeResource",
        latitude=0,
        longitude=0,
        region="string",
        labels={
            "string": "string",
        },
        name="string",
        public=False)
    
    const syntheticMonitoringProbeResource = new grafana.SyntheticMonitoringProbe("syntheticMonitoringProbeResource", {
        latitude: 0,
        longitude: 0,
        region: "string",
        labels: {
            string: "string",
        },
        name: "string",
        "public": false,
    });
    
    type: grafana:SyntheticMonitoringProbe
    properties:
        labels:
            string: string
        latitude: 0
        longitude: 0
        name: string
        public: false
        region: string
    

    SyntheticMonitoringProbe Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    The SyntheticMonitoringProbe resource accepts the following input properties:

    Latitude double
    Latitude coordinates.
    Longitude double
    Longitude coordinates.
    Region string
    Region of the probe.
    Labels Dictionary<string, string>
    Custom labels to be included with collected metrics and logs.
    Name string
    Name of the probe.
    Public bool
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    Latitude float64
    Latitude coordinates.
    Longitude float64
    Longitude coordinates.
    Region string
    Region of the probe.
    Labels map[string]string
    Custom labels to be included with collected metrics and logs.
    Name string
    Name of the probe.
    Public bool
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    latitude Double
    Latitude coordinates.
    longitude Double
    Longitude coordinates.
    region String
    Region of the probe.
    labels Map<String,String>
    Custom labels to be included with collected metrics and logs.
    name String
    Name of the probe.
    public_ Boolean
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    latitude number
    Latitude coordinates.
    longitude number
    Longitude coordinates.
    region string
    Region of the probe.
    labels {[key: string]: string}
    Custom labels to be included with collected metrics and logs.
    name string
    Name of the probe.
    public boolean
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    latitude float
    Latitude coordinates.
    longitude float
    Longitude coordinates.
    region str
    Region of the probe.
    labels Mapping[str, str]
    Custom labels to be included with collected metrics and logs.
    name str
    Name of the probe.
    public bool
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    latitude Number
    Latitude coordinates.
    longitude Number
    Longitude coordinates.
    region String
    Region of the probe.
    labels Map<String>
    Custom labels to be included with collected metrics and logs.
    name String
    Name of the probe.
    public Boolean
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the SyntheticMonitoringProbe resource produces the following output properties:

    AuthToken string
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    Id string
    The provider-assigned unique ID for this managed resource.
    TenantId int
    The tenant ID of the probe.
    AuthToken string
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    Id string
    The provider-assigned unique ID for this managed resource.
    TenantId int
    The tenant ID of the probe.
    authToken String
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    id String
    The provider-assigned unique ID for this managed resource.
    tenantId Integer
    The tenant ID of the probe.
    authToken string
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    id string
    The provider-assigned unique ID for this managed resource.
    tenantId number
    The tenant ID of the probe.
    auth_token str
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    id str
    The provider-assigned unique ID for this managed resource.
    tenant_id int
    The tenant ID of the probe.
    authToken String
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    id String
    The provider-assigned unique ID for this managed resource.
    tenantId Number
    The tenant ID of the probe.

    Look up Existing SyntheticMonitoringProbe Resource

    Get an existing SyntheticMonitoringProbe resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: SyntheticMonitoringProbeState, opts?: CustomResourceOptions): SyntheticMonitoringProbe
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            auth_token: Optional[str] = None,
            labels: Optional[Mapping[str, str]] = None,
            latitude: Optional[float] = None,
            longitude: Optional[float] = None,
            name: Optional[str] = None,
            public: Optional[bool] = None,
            region: Optional[str] = None,
            tenant_id: Optional[int] = None) -> SyntheticMonitoringProbe
    func GetSyntheticMonitoringProbe(ctx *Context, name string, id IDInput, state *SyntheticMonitoringProbeState, opts ...ResourceOption) (*SyntheticMonitoringProbe, error)
    public static SyntheticMonitoringProbe Get(string name, Input<string> id, SyntheticMonitoringProbeState? state, CustomResourceOptions? opts = null)
    public static SyntheticMonitoringProbe get(String name, Output<String> id, SyntheticMonitoringProbeState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AuthToken string
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    Labels Dictionary<string, string>
    Custom labels to be included with collected metrics and logs.
    Latitude double
    Latitude coordinates.
    Longitude double
    Longitude coordinates.
    Name string
    Name of the probe.
    Public bool
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    Region string
    Region of the probe.
    TenantId int
    The tenant ID of the probe.
    AuthToken string
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    Labels map[string]string
    Custom labels to be included with collected metrics and logs.
    Latitude float64
    Latitude coordinates.
    Longitude float64
    Longitude coordinates.
    Name string
    Name of the probe.
    Public bool
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    Region string
    Region of the probe.
    TenantId int
    The tenant ID of the probe.
    authToken String
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    labels Map<String,String>
    Custom labels to be included with collected metrics and logs.
    latitude Double
    Latitude coordinates.
    longitude Double
    Longitude coordinates.
    name String
    Name of the probe.
    public_ Boolean
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    region String
    Region of the probe.
    tenantId Integer
    The tenant ID of the probe.
    authToken string
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    labels {[key: string]: string}
    Custom labels to be included with collected metrics and logs.
    latitude number
    Latitude coordinates.
    longitude number
    Longitude coordinates.
    name string
    Name of the probe.
    public boolean
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    region string
    Region of the probe.
    tenantId number
    The tenant ID of the probe.
    auth_token str
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    labels Mapping[str, str]
    Custom labels to be included with collected metrics and logs.
    latitude float
    Latitude coordinates.
    longitude float
    Longitude coordinates.
    name str
    Name of the probe.
    public bool
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    region str
    Region of the probe.
    tenant_id int
    The tenant ID of the probe.
    authToken String
    The probe authentication token. Your probe must use this to authenticate with Grafana Cloud.
    labels Map<String>
    Custom labels to be included with collected metrics and logs.
    latitude Number
    Latitude coordinates.
    longitude Number
    Longitude coordinates.
    name String
    Name of the probe.
    public Boolean
    Public probes are run by Grafana Labs and can be used by all users. Only Grafana Labs managed public probes will be set to true. Defaults to false.
    region String
    Region of the probe.
    tenantId Number
    The tenant ID of the probe.

    Import

    $ pulumi import grafana:index/syntheticMonitoringProbe:SyntheticMonitoringProbe name "{{ id }}"
    
    $ pulumi import grafana:index/syntheticMonitoringProbe:SyntheticMonitoringProbe name "{{ id }}:{{ authToken }}"
    

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    grafana pulumiverse/pulumi-grafana
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the grafana Terraform Provider.
    grafana logo
    Grafana v0.5.1 published on Wednesday, Jun 12, 2024 by pulumiverse