checkly.CheckGroup
Explore with Pulumi AI
Check groups allow you to group together a set of related checks, which can also share default settings for various attributes.
Example Usage
using Pulumi;
using Checkly = Pulumi.Checkly;
class MyStack : Stack
{
public MyStack()
{
var testGroup1CheckGroup = new Checkly.CheckGroup("testGroup1CheckGroup", new Checkly.CheckGroupArgs
{
Activated = true,
Muted = false,
Tags =
{
"auto",
},
Locations =
{
"eu-west-1",
},
Concurrency = 3,
ApiCheckDefaults = new Checkly.Inputs.CheckGroupApiCheckDefaultsArgs
{
Url = "http://example.com/",
Headers =
{
{ "X-Test", "foo" },
},
QueryParameters =
{
{ "query", "foo" },
},
Assertions =
{
new Checkly.Inputs.CheckGroupApiCheckDefaultsAssertionArgs
{
Source = "STATUS_CODE",
Property = "",
Comparison = "EQUALS",
Target = "200",
},
new Checkly.Inputs.CheckGroupApiCheckDefaultsAssertionArgs
{
Source = "TEXT_BODY",
Property = "",
Comparison = "CONTAINS",
Target = "welcome",
},
},
BasicAuth = new Checkly.Inputs.CheckGroupApiCheckDefaultsBasicAuthArgs
{
Username = "user",
Password = "pass",
},
},
EnvironmentVariables =
{
{ "ENVTEST", "Hello world" },
},
DoubleCheck = true,
UseGlobalAlertSettings = false,
AlertSettings = new Checkly.Inputs.CheckGroupAlertSettingsArgs
{
EscalationType = "RUN_BASED",
RunBasedEscalations =
{
new Checkly.Inputs.CheckGroupAlertSettingsRunBasedEscalationArgs
{
FailedRunThreshold = 1,
},
},
TimeBasedEscalations =
{
new Checkly.Inputs.CheckGroupAlertSettingsTimeBasedEscalationArgs
{
MinutesFailingThreshold = 5,
},
},
Reminders =
{
new Checkly.Inputs.CheckGroupAlertSettingsReminderArgs
{
Amount = 2,
Interval = 5,
},
},
},
LocalSetupScript = "setup-test",
LocalTeardownScript = "teardown-test",
});
// Add a check to a group
var testCheck1 = new Checkly.Check("testCheck1", new Checkly.CheckArgs
{
GroupId = testGroup1CheckGroup.Id,
GroupOrder = 1,
});
// Using with alert channels
var emailAc1 = new Checkly.AlertChannel("emailAc1", new Checkly.AlertChannelArgs
{
Email = new Checkly.Inputs.AlertChannelEmailArgs
{
Address = "info@example.com",
},
});
var emailAc2 = new Checkly.AlertChannel("emailAc2", new Checkly.AlertChannelArgs
{
Email = new Checkly.Inputs.AlertChannelEmailArgs
{
Address = "info2@example.com",
},
});
// Connect the check group to the alert channels
var testGroup1Index_checkGroupCheckGroup = new Checkly.CheckGroup("testGroup1Index/checkGroupCheckGroup", new Checkly.CheckGroupArgs
{
AlertChannelSubscriptions =
{
new Checkly.Inputs.CheckGroupAlertChannelSubscriptionArgs
{
ChannelId = emailAc1.Id,
Activated = true,
},
new Checkly.Inputs.CheckGroupAlertChannelSubscriptionArgs
{
ChannelId = emailAc2.Id,
Activated = true,
},
},
});
}
}
package main
import (
"github.com/checkly/pulumi-checkly/sdk/go/checkly"
"github.com/pulumi/pulumi-checkly/sdk/go/checkly"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
testGroup1CheckGroup, err := checkly.NewCheckGroup(ctx, "testGroup1CheckGroup", &checkly.CheckGroupArgs{
Activated: pulumi.Bool(true),
Muted: pulumi.Bool(false),
Tags: pulumi.StringArray{
pulumi.String("auto"),
},
Locations: pulumi.StringArray{
pulumi.String("eu-west-1"),
},
Concurrency: pulumi.Int(3),
ApiCheckDefaults: &CheckGroupApiCheckDefaultsArgs{
Url: pulumi.String("http://example.com/"),
Headers: pulumi.AnyMap{
"X-Test": pulumi.Any("foo"),
},
QueryParameters: pulumi.AnyMap{
"query": pulumi.Any("foo"),
},
Assertions: CheckGroupApiCheckDefaultsAssertionArray{
&CheckGroupApiCheckDefaultsAssertionArgs{
Source: pulumi.String("STATUS_CODE"),
Property: pulumi.String(""),
Comparison: pulumi.String("EQUALS"),
Target: pulumi.String("200"),
},
&CheckGroupApiCheckDefaultsAssertionArgs{
Source: pulumi.String("TEXT_BODY"),
Property: pulumi.String(""),
Comparison: pulumi.String("CONTAINS"),
Target: pulumi.String("welcome"),
},
},
BasicAuth: &CheckGroupApiCheckDefaultsBasicAuthArgs{
Username: pulumi.String("user"),
Password: pulumi.String("pass"),
},
},
EnvironmentVariables: pulumi.AnyMap{
"ENVTEST": pulumi.Any("Hello world"),
},
DoubleCheck: pulumi.Bool(true),
UseGlobalAlertSettings: pulumi.Bool(false),
AlertSettings: &CheckGroupAlertSettingsArgs{
EscalationType: pulumi.String("RUN_BASED"),
RunBasedEscalations: CheckGroupAlertSettingsRunBasedEscalationArray{
&CheckGroupAlertSettingsRunBasedEscalationArgs{
FailedRunThreshold: pulumi.Int(1),
},
},
TimeBasedEscalations: CheckGroupAlertSettingsTimeBasedEscalationArray{
&CheckGroupAlertSettingsTimeBasedEscalationArgs{
MinutesFailingThreshold: pulumi.Int(5),
},
},
Reminders: CheckGroupAlertSettingsReminderArray{
&CheckGroupAlertSettingsReminderArgs{
Amount: pulumi.Int(2),
Interval: pulumi.Int(5),
},
},
},
LocalSetupScript: pulumi.String("setup-test"),
LocalTeardownScript: pulumi.String("teardown-test"),
})
if err != nil {
return err
}
_, err = checkly.NewCheck(ctx, "testCheck1", &checkly.CheckArgs{
GroupId: testGroup1CheckGroup.ID(),
GroupOrder: pulumi.Int(1),
})
if err != nil {
return err
}
emailAc1, err := checkly.NewAlertChannel(ctx, "emailAc1", &checkly.AlertChannelArgs{
Email: &AlertChannelEmailArgs{
Address: pulumi.String("info@example.com"),
},
})
if err != nil {
return err
}
emailAc2, err := checkly.NewAlertChannel(ctx, "emailAc2", &checkly.AlertChannelArgs{
Email: &AlertChannelEmailArgs{
Address: pulumi.String("info2@example.com"),
},
})
if err != nil {
return err
}
_, err = checkly.NewCheckGroup(ctx, "testGroup1Index/checkGroupCheckGroup", &checkly.CheckGroupArgs{
AlertChannelSubscriptions: CheckGroupAlertChannelSubscriptionArray{
&CheckGroupAlertChannelSubscriptionArgs{
ChannelId: emailAc1.ID(),
Activated: pulumi.Bool(true),
},
&CheckGroupAlertChannelSubscriptionArgs{
ChannelId: emailAc2.ID(),
Activated: pulumi.Bool(true),
},
},
})
if err != nil {
return err
}
return nil
})
}
Coming soon!
import pulumi
import pulumi_checkly as checkly
test_group1_check_group = checkly.CheckGroup("testGroup1CheckGroup",
activated=True,
muted=False,
tags=["auto"],
locations=["eu-west-1"],
concurrency=3,
api_check_defaults=checkly.CheckGroupApiCheckDefaultsArgs(
url="http://example.com/",
headers={
"X-Test": "foo",
},
query_parameters={
"query": "foo",
},
assertions=[
checkly.CheckGroupApiCheckDefaultsAssertionArgs(
source="STATUS_CODE",
property="",
comparison="EQUALS",
target="200",
),
checkly.CheckGroupApiCheckDefaultsAssertionArgs(
source="TEXT_BODY",
property="",
comparison="CONTAINS",
target="welcome",
),
],
basic_auth=checkly.CheckGroupApiCheckDefaultsBasicAuthArgs(
username="user",
password="pass",
),
),
environment_variables={
"ENVTEST": "Hello world",
},
double_check=True,
use_global_alert_settings=False,
alert_settings=checkly.CheckGroupAlertSettingsArgs(
escalation_type="RUN_BASED",
run_based_escalations=[checkly.CheckGroupAlertSettingsRunBasedEscalationArgs(
failed_run_threshold=1,
)],
time_based_escalations=[checkly.CheckGroupAlertSettingsTimeBasedEscalationArgs(
minutes_failing_threshold=5,
)],
reminders=[checkly.CheckGroupAlertSettingsReminderArgs(
amount=2,
interval=5,
)],
),
local_setup_script="setup-test",
local_teardown_script="teardown-test")
# Add a check to a group
test_check1 = checkly.Check("testCheck1",
group_id=test_group1_check_group.id,
group_order=1)
# Using with alert channels
email_ac1 = checkly.AlertChannel("emailAc1", email=checkly.AlertChannelEmailArgs(
address="info@example.com",
))
email_ac2 = checkly.AlertChannel("emailAc2", email=checkly.AlertChannelEmailArgs(
address="info2@example.com",
))
# Connect the check group to the alert channels
test_group1_index_check_group_check_group = checkly.CheckGroup("testGroup1Index/checkGroupCheckGroup", alert_channel_subscriptions=[
checkly.CheckGroupAlertChannelSubscriptionArgs(
channel_id=email_ac1.id,
activated=True,
),
checkly.CheckGroupAlertChannelSubscriptionArgs(
channel_id=email_ac2.id,
activated=True,
),
])
import * as pulumi from "@pulumi/pulumi";
import * as pulumi from "@checkly/pulumi";
const testGroup1CheckGroup = new checkly.CheckGroup("testGroup1CheckGroup", {
activated: true,
muted: false,
tags: ["auto"],
locations: ["eu-west-1"],
concurrency: 3,
apiCheckDefaults: {
url: "http://example.com/",
headers: {
"X-Test": "foo",
},
queryParameters: {
query: "foo",
},
assertions: [
{
source: "STATUS_CODE",
property: "",
comparison: "EQUALS",
target: "200",
},
{
source: "TEXT_BODY",
property: "",
comparison: "CONTAINS",
target: "welcome",
},
],
basicAuth: {
username: "user",
password: "pass",
},
},
environmentVariables: {
ENVTEST: "Hello world",
},
doubleCheck: true,
useGlobalAlertSettings: false,
alertSettings: {
escalationType: "RUN_BASED",
runBasedEscalations: [{
failedRunThreshold: 1,
}],
timeBasedEscalations: [{
minutesFailingThreshold: 5,
}],
reminders: [{
amount: 2,
interval: 5,
}],
},
localSetupScript: "setup-test",
localTeardownScript: "teardown-test",
});
// Add a check to a group
const testCheck1 = new checkly.Check("testCheck1", {
groupId: testGroup1CheckGroup.id,
groupOrder: 1,
});
// Using with alert channels
const emailAc1 = new checkly.AlertChannel("emailAc1", {email: {
address: "info@example.com",
}});
const emailAc2 = new checkly.AlertChannel("emailAc2", {email: {
address: "info2@example.com",
}});
// Connect the check group to the alert channels
const testGroup1Index_checkGroupCheckGroup = new checkly.CheckGroup("testGroup1Index/checkGroupCheckGroup", {alertChannelSubscriptions: [
{
channelId: emailAc1.id,
activated: true,
},
{
channelId: emailAc2.id,
activated: true,
},
]});
Coming soon!
Create CheckGroup Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new CheckGroup(name: string, args: CheckGroupArgs, opts?: CustomResourceOptions);
@overload
def CheckGroup(resource_name: str,
args: CheckGroupArgs,
opts: Optional[ResourceOptions] = None)
@overload
def CheckGroup(resource_name: str,
opts: Optional[ResourceOptions] = None,
concurrency: Optional[int] = None,
activated: Optional[bool] = None,
local_teardown_script: Optional[str] = None,
locations: Optional[Sequence[str]] = None,
alert_settings: Optional[CheckGroupAlertSettingsArgs] = None,
double_check: Optional[bool] = None,
environment_variables: Optional[Mapping[str, Any]] = None,
local_setup_script: Optional[str] = None,
alert_channel_subscriptions: Optional[Sequence[CheckGroupAlertChannelSubscriptionArgs]] = None,
api_check_defaults: Optional[CheckGroupApiCheckDefaultsArgs] = None,
muted: Optional[bool] = None,
name: Optional[str] = None,
private_locations: Optional[Sequence[str]] = None,
runtime_id: Optional[str] = None,
setup_snippet_id: Optional[int] = None,
tags: Optional[Sequence[str]] = None,
teardown_snippet_id: Optional[int] = None,
use_global_alert_settings: Optional[bool] = None)
func NewCheckGroup(ctx *Context, name string, args CheckGroupArgs, opts ...ResourceOption) (*CheckGroup, error)
public CheckGroup(string name, CheckGroupArgs args, CustomResourceOptions? opts = null)
public CheckGroup(String name, CheckGroupArgs args)
public CheckGroup(String name, CheckGroupArgs args, CustomResourceOptions options)
type: checkly:CheckGroup
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 CheckGroupArgs
- 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 CheckGroupArgs
- 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 CheckGroupArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args CheckGroupArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args CheckGroupArgs
- 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 checkGroupResource = new Checkly.CheckGroup("checkGroupResource", new()
{
Concurrency = 0,
Activated = false,
LocalTeardownScript = "string",
Locations = new[]
{
"string",
},
AlertSettings = new Checkly.Inputs.CheckGroupAlertSettingsArgs
{
EscalationType = "string",
Reminders = new[]
{
new Checkly.Inputs.CheckGroupAlertSettingsReminderArgs
{
Amount = 0,
Interval = 0,
},
},
RunBasedEscalations = new[]
{
new Checkly.Inputs.CheckGroupAlertSettingsRunBasedEscalationArgs
{
FailedRunThreshold = 0,
},
},
TimeBasedEscalations = new[]
{
new Checkly.Inputs.CheckGroupAlertSettingsTimeBasedEscalationArgs
{
MinutesFailingThreshold = 0,
},
},
},
DoubleCheck = false,
LocalSetupScript = "string",
AlertChannelSubscriptions = new[]
{
new Checkly.Inputs.CheckGroupAlertChannelSubscriptionArgs
{
Activated = false,
ChannelId = 0,
},
},
ApiCheckDefaults = new Checkly.Inputs.CheckGroupApiCheckDefaultsArgs
{
Assertions = new[]
{
new Checkly.Inputs.CheckGroupApiCheckDefaultsAssertionArgs
{
Comparison = "string",
Source = "string",
Target = "string",
Property = "string",
},
},
BasicAuth = new Checkly.Inputs.CheckGroupApiCheckDefaultsBasicAuthArgs
{
Password = "string",
Username = "string",
},
Headers =
{
{ "string", "any" },
},
QueryParameters =
{
{ "string", "any" },
},
Url = "string",
},
Muted = false,
Name = "string",
PrivateLocations = new[]
{
"string",
},
RuntimeId = "string",
SetupSnippetId = 0,
Tags = new[]
{
"string",
},
TeardownSnippetId = 0,
UseGlobalAlertSettings = false,
});
example, err := checkly.NewCheckGroup(ctx, "checkGroupResource", &checkly.CheckGroupArgs{
Concurrency: pulumi.Int(0),
Activated: pulumi.Bool(false),
LocalTeardownScript: pulumi.String("string"),
Locations: pulumi.StringArray{
pulumi.String("string"),
},
AlertSettings: &checkly.CheckGroupAlertSettingsArgs{
EscalationType: pulumi.String("string"),
Reminders: checkly.CheckGroupAlertSettingsReminderArray{
&checkly.CheckGroupAlertSettingsReminderArgs{
Amount: pulumi.Int(0),
Interval: pulumi.Int(0),
},
},
RunBasedEscalations: checkly.CheckGroupAlertSettingsRunBasedEscalationArray{
&checkly.CheckGroupAlertSettingsRunBasedEscalationArgs{
FailedRunThreshold: pulumi.Int(0),
},
},
TimeBasedEscalations: checkly.CheckGroupAlertSettingsTimeBasedEscalationArray{
&checkly.CheckGroupAlertSettingsTimeBasedEscalationArgs{
MinutesFailingThreshold: pulumi.Int(0),
},
},
},
DoubleCheck: pulumi.Bool(false),
LocalSetupScript: pulumi.String("string"),
AlertChannelSubscriptions: checkly.CheckGroupAlertChannelSubscriptionArray{
&checkly.CheckGroupAlertChannelSubscriptionArgs{
Activated: pulumi.Bool(false),
ChannelId: pulumi.Int(0),
},
},
ApiCheckDefaults: &checkly.CheckGroupApiCheckDefaultsArgs{
Assertions: checkly.CheckGroupApiCheckDefaultsAssertionArray{
&checkly.CheckGroupApiCheckDefaultsAssertionArgs{
Comparison: pulumi.String("string"),
Source: pulumi.String("string"),
Target: pulumi.String("string"),
Property: pulumi.String("string"),
},
},
BasicAuth: &checkly.CheckGroupApiCheckDefaultsBasicAuthArgs{
Password: pulumi.String("string"),
Username: pulumi.String("string"),
},
Headers: pulumi.Map{
"string": pulumi.Any("any"),
},
QueryParameters: pulumi.Map{
"string": pulumi.Any("any"),
},
Url: pulumi.String("string"),
},
Muted: pulumi.Bool(false),
Name: pulumi.String("string"),
PrivateLocations: pulumi.StringArray{
pulumi.String("string"),
},
RuntimeId: pulumi.String("string"),
SetupSnippetId: pulumi.Int(0),
Tags: pulumi.StringArray{
pulumi.String("string"),
},
TeardownSnippetId: pulumi.Int(0),
UseGlobalAlertSettings: pulumi.Bool(false),
})
var checkGroupResource = new CheckGroup("checkGroupResource", CheckGroupArgs.builder()
.concurrency(0)
.activated(false)
.localTeardownScript("string")
.locations("string")
.alertSettings(CheckGroupAlertSettingsArgs.builder()
.escalationType("string")
.reminders(CheckGroupAlertSettingsReminderArgs.builder()
.amount(0)
.interval(0)
.build())
.runBasedEscalations(CheckGroupAlertSettingsRunBasedEscalationArgs.builder()
.failedRunThreshold(0)
.build())
.timeBasedEscalations(CheckGroupAlertSettingsTimeBasedEscalationArgs.builder()
.minutesFailingThreshold(0)
.build())
.build())
.doubleCheck(false)
.localSetupScript("string")
.alertChannelSubscriptions(CheckGroupAlertChannelSubscriptionArgs.builder()
.activated(false)
.channelId(0)
.build())
.apiCheckDefaults(CheckGroupApiCheckDefaultsArgs.builder()
.assertions(CheckGroupApiCheckDefaultsAssertionArgs.builder()
.comparison("string")
.source("string")
.target("string")
.property("string")
.build())
.basicAuth(CheckGroupApiCheckDefaultsBasicAuthArgs.builder()
.password("string")
.username("string")
.build())
.headers(Map.of("string", "any"))
.queryParameters(Map.of("string", "any"))
.url("string")
.build())
.muted(false)
.name("string")
.privateLocations("string")
.runtimeId("string")
.setupSnippetId(0)
.tags("string")
.teardownSnippetId(0)
.useGlobalAlertSettings(false)
.build());
check_group_resource = checkly.CheckGroup("checkGroupResource",
concurrency=0,
activated=False,
local_teardown_script="string",
locations=["string"],
alert_settings={
"escalation_type": "string",
"reminders": [{
"amount": 0,
"interval": 0,
}],
"run_based_escalations": [{
"failed_run_threshold": 0,
}],
"time_based_escalations": [{
"minutes_failing_threshold": 0,
}],
},
double_check=False,
local_setup_script="string",
alert_channel_subscriptions=[{
"activated": False,
"channel_id": 0,
}],
api_check_defaults={
"assertions": [{
"comparison": "string",
"source": "string",
"target": "string",
"property": "string",
}],
"basic_auth": {
"password": "string",
"username": "string",
},
"headers": {
"string": "any",
},
"query_parameters": {
"string": "any",
},
"url": "string",
},
muted=False,
name="string",
private_locations=["string"],
runtime_id="string",
setup_snippet_id=0,
tags=["string"],
teardown_snippet_id=0,
use_global_alert_settings=False)
const checkGroupResource = new checkly.CheckGroup("checkGroupResource", {
concurrency: 0,
activated: false,
localTeardownScript: "string",
locations: ["string"],
alertSettings: {
escalationType: "string",
reminders: [{
amount: 0,
interval: 0,
}],
runBasedEscalations: [{
failedRunThreshold: 0,
}],
timeBasedEscalations: [{
minutesFailingThreshold: 0,
}],
},
doubleCheck: false,
localSetupScript: "string",
alertChannelSubscriptions: [{
activated: false,
channelId: 0,
}],
apiCheckDefaults: {
assertions: [{
comparison: "string",
source: "string",
target: "string",
property: "string",
}],
basicAuth: {
password: "string",
username: "string",
},
headers: {
string: "any",
},
queryParameters: {
string: "any",
},
url: "string",
},
muted: false,
name: "string",
privateLocations: ["string"],
runtimeId: "string",
setupSnippetId: 0,
tags: ["string"],
teardownSnippetId: 0,
useGlobalAlertSettings: false,
});
type: checkly:CheckGroup
properties:
activated: false
alertChannelSubscriptions:
- activated: false
channelId: 0
alertSettings:
escalationType: string
reminders:
- amount: 0
interval: 0
runBasedEscalations:
- failedRunThreshold: 0
timeBasedEscalations:
- minutesFailingThreshold: 0
apiCheckDefaults:
assertions:
- comparison: string
property: string
source: string
target: string
basicAuth:
password: string
username: string
headers:
string: any
queryParameters:
string: any
url: string
concurrency: 0
doubleCheck: false
localSetupScript: string
localTeardownScript: string
locations:
- string
muted: false
name: string
privateLocations:
- string
runtimeId: string
setupSnippetId: 0
tags:
- string
teardownSnippetId: 0
useGlobalAlertSettings: false
CheckGroup Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The CheckGroup resource accepts the following input properties:
- Activated bool
- Determines if the checks in the group are running or not.
- Concurrency int
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- Alert
Channel List<CheckSubscriptions Group Alert Channel Subscription> - Alert
Settings CheckGroup Alert Settings - Api
Check CheckDefaults Group Api Check Defaults - Double
Check bool - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - Environment
Variables Dictionary<string, object> - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- Local
Setup stringScript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- Local
Teardown stringScript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- Locations List<string>
- An array of one or more data center locations where to run the checks.
- Muted bool
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- Name string
- The name of the check group.
- Private
Locations List<string> - An array of one or more private locations slugs.
- Runtime
Id string - The id of the runtime to use for this group.
- Setup
Snippet intId - An ID reference to a snippet to use in the setup phase of an API check.
- List<string>
- Tags for organizing and filtering checks.
- Teardown
Snippet intId - An ID reference to a snippet to use in the teardown phase of an API check.
- Use
Global boolAlert Settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
- Activated bool
- Determines if the checks in the group are running or not.
- Concurrency int
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- Alert
Channel []CheckSubscriptions Group Alert Channel Subscription Args - Alert
Settings CheckGroup Alert Settings Args - Api
Check CheckDefaults Group Api Check Defaults Args - Double
Check bool - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - Environment
Variables map[string]interface{} - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- Local
Setup stringScript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- Local
Teardown stringScript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- Locations []string
- An array of one or more data center locations where to run the checks.
- Muted bool
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- Name string
- The name of the check group.
- Private
Locations []string - An array of one or more private locations slugs.
- Runtime
Id string - The id of the runtime to use for this group.
- Setup
Snippet intId - An ID reference to a snippet to use in the setup phase of an API check.
- []string
- Tags for organizing and filtering checks.
- Teardown
Snippet intId - An ID reference to a snippet to use in the teardown phase of an API check.
- Use
Global boolAlert Settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated Boolean
- Determines if the checks in the group are running or not.
- concurrency Integer
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- alert
Channel List<CheckSubscriptions Group Alert Channel Subscription> - alert
Settings CheckGroup Alert Settings - api
Check CheckDefaults Group Api Check Defaults - double
Check Boolean - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - environment
Variables Map<String,Object> - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- local
Setup StringScript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown StringScript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations List<String>
- An array of one or more data center locations where to run the checks.
- muted Boolean
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name String
- The name of the check group.
- private
Locations List<String> - An array of one or more private locations slugs.
- runtime
Id String - The id of the runtime to use for this group.
- setup
Snippet IntegerId - An ID reference to a snippet to use in the setup phase of an API check.
- List<String>
- Tags for organizing and filtering checks.
- teardown
Snippet IntegerId - An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global BooleanAlert Settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated boolean
- Determines if the checks in the group are running or not.
- concurrency number
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- alert
Channel CheckSubscriptions Group Alert Channel Subscription[] - alert
Settings CheckGroup Alert Settings - api
Check CheckDefaults Group Api Check Defaults - double
Check boolean - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - environment
Variables {[key: string]: any} - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- local
Setup stringScript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown stringScript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations string[]
- An array of one or more data center locations where to run the checks.
- muted boolean
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name string
- The name of the check group.
- private
Locations string[] - An array of one or more private locations slugs.
- runtime
Id string - The id of the runtime to use for this group.
- setup
Snippet numberId - An ID reference to a snippet to use in the setup phase of an API check.
- string[]
- Tags for organizing and filtering checks.
- teardown
Snippet numberId - An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global booleanAlert Settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated bool
- Determines if the checks in the group are running or not.
- concurrency int
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- alert_
channel_ Sequence[Checksubscriptions Group Alert Channel Subscription Args] - alert_
settings CheckGroup Alert Settings Args - api_
check_ Checkdefaults Group Api Check Defaults Args - double_
check bool - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - environment_
variables Mapping[str, Any] - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- local_
setup_ strscript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local_
teardown_ strscript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations Sequence[str]
- An array of one or more data center locations where to run the checks.
- muted bool
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name str
- The name of the check group.
- private_
locations Sequence[str] - An array of one or more private locations slugs.
- runtime_
id str - The id of the runtime to use for this group.
- setup_
snippet_ intid - An ID reference to a snippet to use in the setup phase of an API check.
- Sequence[str]
- Tags for organizing and filtering checks.
- teardown_
snippet_ intid - An ID reference to a snippet to use in the teardown phase of an API check.
- use_
global_ boolalert_ settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated Boolean
- Determines if the checks in the group are running or not.
- concurrency Number
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- alert
Channel List<Property Map>Subscriptions - alert
Settings Property Map - api
Check Property MapDefaults - double
Check Boolean - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - environment
Variables Map<Any> - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- local
Setup StringScript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown StringScript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations List<String>
- An array of one or more data center locations where to run the checks.
- muted Boolean
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name String
- The name of the check group.
- private
Locations List<String> - An array of one or more private locations slugs.
- runtime
Id String - The id of the runtime to use for this group.
- setup
Snippet NumberId - An ID reference to a snippet to use in the setup phase of an API check.
- List<String>
- Tags for organizing and filtering checks.
- teardown
Snippet NumberId - An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global BooleanAlert Settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
Outputs
All input properties are implicitly available as output properties. Additionally, the CheckGroup resource produces the following output properties:
- Id string
- The provider-assigned unique ID for this managed resource.
- Id string
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
- id string
- The provider-assigned unique ID for this managed resource.
- id str
- The provider-assigned unique ID for this managed resource.
- id String
- The provider-assigned unique ID for this managed resource.
Look up Existing CheckGroup Resource
Get an existing CheckGroup 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?: CheckGroupState, opts?: CustomResourceOptions): CheckGroup
@staticmethod
def get(resource_name: str,
id: str,
opts: Optional[ResourceOptions] = None,
activated: Optional[bool] = None,
alert_channel_subscriptions: Optional[Sequence[CheckGroupAlertChannelSubscriptionArgs]] = None,
alert_settings: Optional[CheckGroupAlertSettingsArgs] = None,
api_check_defaults: Optional[CheckGroupApiCheckDefaultsArgs] = None,
concurrency: Optional[int] = None,
double_check: Optional[bool] = None,
environment_variables: Optional[Mapping[str, Any]] = None,
local_setup_script: Optional[str] = None,
local_teardown_script: Optional[str] = None,
locations: Optional[Sequence[str]] = None,
muted: Optional[bool] = None,
name: Optional[str] = None,
private_locations: Optional[Sequence[str]] = None,
runtime_id: Optional[str] = None,
setup_snippet_id: Optional[int] = None,
tags: Optional[Sequence[str]] = None,
teardown_snippet_id: Optional[int] = None,
use_global_alert_settings: Optional[bool] = None) -> CheckGroup
func GetCheckGroup(ctx *Context, name string, id IDInput, state *CheckGroupState, opts ...ResourceOption) (*CheckGroup, error)
public static CheckGroup Get(string name, Input<string> id, CheckGroupState? state, CustomResourceOptions? opts = null)
public static CheckGroup get(String name, Output<String> id, CheckGroupState 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.
- Activated bool
- Determines if the checks in the group are running or not.
- Alert
Channel List<CheckSubscriptions Group Alert Channel Subscription> - Alert
Settings CheckGroup Alert Settings - Api
Check CheckDefaults Group Api Check Defaults - Concurrency int
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- Double
Check bool - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - Environment
Variables Dictionary<string, object> - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- Local
Setup stringScript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- Local
Teardown stringScript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- Locations List<string>
- An array of one or more data center locations where to run the checks.
- Muted bool
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- Name string
- The name of the check group.
- Private
Locations List<string> - An array of one or more private locations slugs.
- Runtime
Id string - The id of the runtime to use for this group.
- Setup
Snippet intId - An ID reference to a snippet to use in the setup phase of an API check.
- List<string>
- Tags for organizing and filtering checks.
- Teardown
Snippet intId - An ID reference to a snippet to use in the teardown phase of an API check.
- Use
Global boolAlert Settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
- Activated bool
- Determines if the checks in the group are running or not.
- Alert
Channel []CheckSubscriptions Group Alert Channel Subscription Args - Alert
Settings CheckGroup Alert Settings Args - Api
Check CheckDefaults Group Api Check Defaults Args - Concurrency int
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- Double
Check bool - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - Environment
Variables map[string]interface{} - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- Local
Setup stringScript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- Local
Teardown stringScript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- Locations []string
- An array of one or more data center locations where to run the checks.
- Muted bool
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- Name string
- The name of the check group.
- Private
Locations []string - An array of one or more private locations slugs.
- Runtime
Id string - The id of the runtime to use for this group.
- Setup
Snippet intId - An ID reference to a snippet to use in the setup phase of an API check.
- []string
- Tags for organizing and filtering checks.
- Teardown
Snippet intId - An ID reference to a snippet to use in the teardown phase of an API check.
- Use
Global boolAlert Settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated Boolean
- Determines if the checks in the group are running or not.
- alert
Channel List<CheckSubscriptions Group Alert Channel Subscription> - alert
Settings CheckGroup Alert Settings - api
Check CheckDefaults Group Api Check Defaults - concurrency Integer
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- double
Check Boolean - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - environment
Variables Map<String,Object> - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- local
Setup StringScript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown StringScript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations List<String>
- An array of one or more data center locations where to run the checks.
- muted Boolean
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name String
- The name of the check group.
- private
Locations List<String> - An array of one or more private locations slugs.
- runtime
Id String - The id of the runtime to use for this group.
- setup
Snippet IntegerId - An ID reference to a snippet to use in the setup phase of an API check.
- List<String>
- Tags for organizing and filtering checks.
- teardown
Snippet IntegerId - An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global BooleanAlert Settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated boolean
- Determines if the checks in the group are running or not.
- alert
Channel CheckSubscriptions Group Alert Channel Subscription[] - alert
Settings CheckGroup Alert Settings - api
Check CheckDefaults Group Api Check Defaults - concurrency number
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- double
Check boolean - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - environment
Variables {[key: string]: any} - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- local
Setup stringScript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown stringScript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations string[]
- An array of one or more data center locations where to run the checks.
- muted boolean
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name string
- The name of the check group.
- private
Locations string[] - An array of one or more private locations slugs.
- runtime
Id string - The id of the runtime to use for this group.
- setup
Snippet numberId - An ID reference to a snippet to use in the setup phase of an API check.
- string[]
- Tags for organizing and filtering checks.
- teardown
Snippet numberId - An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global booleanAlert Settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated bool
- Determines if the checks in the group are running or not.
- alert_
channel_ Sequence[Checksubscriptions Group Alert Channel Subscription Args] - alert_
settings CheckGroup Alert Settings Args - api_
check_ Checkdefaults Group Api Check Defaults Args - concurrency int
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- double_
check bool - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - environment_
variables Mapping[str, Any] - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- local_
setup_ strscript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local_
teardown_ strscript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations Sequence[str]
- An array of one or more data center locations where to run the checks.
- muted bool
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name str
- The name of the check group.
- private_
locations Sequence[str] - An array of one or more private locations slugs.
- runtime_
id str - The id of the runtime to use for this group.
- setup_
snippet_ intid - An ID reference to a snippet to use in the setup phase of an API check.
- Sequence[str]
- Tags for organizing and filtering checks.
- teardown_
snippet_ intid - An ID reference to a snippet to use in the teardown phase of an API check.
- use_
global_ boolalert_ settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
- activated Boolean
- Determines if the checks in the group are running or not.
- alert
Channel List<Property Map>Subscriptions - alert
Settings Property Map - api
Check Property MapDefaults - concurrency Number
- Determines how many checks are run concurrently when triggering a check group from CI/CD or through the API.
- double
Check Boolean - Setting this to
true
will trigger a retry when a check fails from the failing region and another, randomly selected region before marking the check as failed. - environment
Variables Map<Any> - Key/value pairs for setting environment variables during check execution. These are only relevant for browser checks. Use global environment variables whenever possible.
- local
Setup StringScript - A valid piece of Node.js code to run in the setup phase of an API check in this group.
- local
Teardown StringScript - A valid piece of Node.js code to run in the teardown phase of an API check in this group.
- locations List<String>
- An array of one or more data center locations where to run the checks.
- muted Boolean
- Determines if any notifications will be sent out when a check in this group fails and/or recovers.
- name String
- The name of the check group.
- private
Locations List<String> - An array of one or more private locations slugs.
- runtime
Id String - The id of the runtime to use for this group.
- setup
Snippet NumberId - An ID reference to a snippet to use in the setup phase of an API check.
- List<String>
- Tags for organizing and filtering checks.
- teardown
Snippet NumberId - An ID reference to a snippet to use in the teardown phase of an API check.
- use
Global BooleanAlert Settings - When true, the account level alert settings will be used, not the alert setting defined on this check group.
Supporting Types
CheckGroupAlertChannelSubscription, CheckGroupAlertChannelSubscriptionArgs
- activated bool
- channel_
id int
CheckGroupAlertSettings, CheckGroupAlertSettingsArgs
CheckGroupAlertSettingsReminder, CheckGroupAlertSettingsReminderArgs
CheckGroupAlertSettingsRunBasedEscalation, CheckGroupAlertSettingsRunBasedEscalationArgs
- failed
Run IntegerThreshold
- failed
Run numberThreshold
- failed
Run NumberThreshold
CheckGroupAlertSettingsSslCertificate, CheckGroupAlertSettingsSslCertificateArgs
- Alert
Threshold int - Enabled bool
- Alert
Threshold int - Enabled bool
- alert
Threshold Integer - enabled Boolean
- alert
Threshold number - enabled boolean
- alert_
threshold int - enabled bool
- alert
Threshold Number - enabled Boolean
CheckGroupAlertSettingsTimeBasedEscalation, CheckGroupAlertSettingsTimeBasedEscalationArgs
- minutes
Failing IntegerThreshold
- minutes
Failing numberThreshold
- minutes
Failing NumberThreshold
CheckGroupApiCheckDefaults, CheckGroupApiCheckDefaultsArgs
- Assertions
List<Check
Group Api Check Defaults Assertion> - Basic
Auth CheckGroup Api Check Defaults Basic Auth - Headers Dictionary<string, object>
- Query
Parameters Dictionary<string, object> - Url string
- Assertions
[]Check
Group Api Check Defaults Assertion - Basic
Auth CheckGroup Api Check Defaults Basic Auth - Headers map[string]interface{}
- Query
Parameters map[string]interface{} - Url string
- assertions
List<Check
Group Api Check Defaults Assertion> - basic
Auth CheckGroup Api Check Defaults Basic Auth - headers Map<String,Object>
- query
Parameters Map<String,Object> - url String
- assertions
Check
Group Api Check Defaults Assertion[] - basic
Auth CheckGroup Api Check Defaults Basic Auth - headers {[key: string]: any}
- query
Parameters {[key: string]: any} - url string
- assertions
Sequence[Check
Group Api Check Defaults Assertion] - basic_
auth CheckGroup Api Check Defaults Basic Auth - headers Mapping[str, Any]
- query_
parameters Mapping[str, Any] - url str
- assertions List<Property Map>
- basic
Auth Property Map - headers Map<Any>
- query
Parameters Map<Any> - url String
CheckGroupApiCheckDefaultsAssertion, CheckGroupApiCheckDefaultsAssertionArgs
- Comparison string
- Source string
- Target string
- Property string
- Comparison string
- Source string
- Target string
- Property string
- comparison String
- source String
- target String
- property String
- comparison string
- source string
- target string
- property string
- comparison str
- source str
- target str
- property str
- comparison String
- source String
- target String
- property String
CheckGroupApiCheckDefaultsBasicAuth, CheckGroupApiCheckDefaultsBasicAuthArgs
Package Details
- Repository
- checkly checkly/pulumi-checkly
- License
- MIT
- Notes
- This Pulumi package is based on the
checkly
Terraform Provider.