1. Packages
  2. Packages
  3. Newrelic Provider
  4. API Docs
  5. AlertCondition
Viewing docs for New Relic v4.20.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi
newrelic logo
Viewing docs for New Relic v4.20.0 (Older version)
published on Monday, Mar 9, 2026 by Pulumi

    Use this resource to create and manage alert conditions for APM, Browser, and Mobile in New Relic.

    NOTE: The newrelic.NrqlAlertCondition resource is preferred for configuring alerts conditions. In most cases feature parity can be achieved with a NRQL query. Other condition types may be deprecated in the future and receive fewer product updates.

    Terms

    The term mapping supports the following arguments:

    • duration - (Required) In minutes, must be in the range of 5 to 120, inclusive.
    • operator - (Optional) above, below, or equal. Defaults to equal.
    • priority - (Optional) critical or warning. Defaults to critical. Terms must include at least one critical priority term
    • threshold - (Required) Must be 0 or greater.
    • time_function - (Required) all or any.

    Example Usage

    using System.Collections.Generic;
    using Pulumi;
    using NewRelic = Pulumi.NewRelic;
    
    return await Deployment.RunAsync(() => 
    {
        var app = NewRelic.GetEntity.Invoke(new()
        {
            Name = "my-app",
            Type = "APPLICATION",
            Domain = "APM",
        });
    
        var fooAlertPolicy = new NewRelic.AlertPolicy("fooAlertPolicy");
    
        var fooAlertCondition = new NewRelic.AlertCondition("fooAlertCondition", new()
        {
            PolicyId = fooAlertPolicy.Id,
            Type = "apm_app_metric",
            Entities = new[]
            {
                app.Apply(getEntityResult => getEntityResult.ApplicationId),
            },
            Metric = "apdex",
            RunbookUrl = "https://www.example.com",
            ConditionScope = "application",
            Terms = new[]
            {
                new NewRelic.Inputs.AlertConditionTermArgs
                {
                    Duration = 5,
                    Operator = "below",
                    Priority = "critical",
                    Threshold = 0.75,
                    TimeFunction = "all",
                },
            },
        });
    
    });
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-newrelic/sdk/v4/go/newrelic"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		app, err := newrelic.GetEntity(ctx, &GetEntityArgs{
    			Name:   "my-app",
    			Type:   pulumi.StringRef("APPLICATION"),
    			Domain: pulumi.StringRef("APM"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		fooAlertPolicy, err := newrelic.NewAlertPolicy(ctx, "fooAlertPolicy", nil)
    		if err != nil {
    			return err
    		}
    		_, err = newrelic.NewAlertCondition(ctx, "fooAlertCondition", &newrelic.AlertConditionArgs{
    			PolicyId: fooAlertPolicy.ID(),
    			Type:     pulumi.String("apm_app_metric"),
    			Entities: pulumi.IntArray{
    				pulumi.Int(app.ApplicationId),
    			},
    			Metric:         pulumi.String("apdex"),
    			RunbookUrl:     pulumi.String("https://www.example.com"),
    			ConditionScope: pulumi.String("application"),
    			Terms: AlertConditionTermArray{
    				&AlertConditionTermArgs{
    					Duration:     pulumi.Int(5),
    					Operator:     pulumi.String("below"),
    					Priority:     pulumi.String("critical"),
    					Threshold:    pulumi.Float64(0.75),
    					TimeFunction: pulumi.String("all"),
    				},
    			},
    		})
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.newrelic.NewrelicFunctions;
    import com.pulumi.newrelic.inputs.GetEntityArgs;
    import com.pulumi.newrelic.AlertPolicy;
    import com.pulumi.newrelic.AlertCondition;
    import com.pulumi.newrelic.AlertConditionArgs;
    import com.pulumi.newrelic.inputs.AlertConditionTermArgs;
    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) {
            final var app = NewrelicFunctions.getEntity(GetEntityArgs.builder()
                .name("my-app")
                .type("APPLICATION")
                .domain("APM")
                .build());
    
            var fooAlertPolicy = new AlertPolicy("fooAlertPolicy");
    
            var fooAlertCondition = new AlertCondition("fooAlertCondition", AlertConditionArgs.builder()        
                .policyId(fooAlertPolicy.id())
                .type("apm_app_metric")
                .entities(app.applyValue(getEntityResult -> getEntityResult.applicationId()))
                .metric("apdex")
                .runbookUrl("https://www.example.com")
                .conditionScope("application")
                .terms(AlertConditionTermArgs.builder()
                    .duration(5)
                    .operator("below")
                    .priority("critical")
                    .threshold("0.75")
                    .timeFunction("all")
                    .build())
                .build());
    
        }
    }
    
    import * as pulumi from "@pulumi/pulumi";
    import * as newrelic from "@pulumi/newrelic";
    
    const app = newrelic.getEntity({
        name: "my-app",
        type: "APPLICATION",
        domain: "APM",
    });
    const fooAlertPolicy = new newrelic.AlertPolicy("fooAlertPolicy", {});
    const fooAlertCondition = new newrelic.AlertCondition("fooAlertCondition", {
        policyId: fooAlertPolicy.id,
        type: "apm_app_metric",
        entities: [app.then(app => app.applicationId)],
        metric: "apdex",
        runbookUrl: "https://www.example.com",
        conditionScope: "application",
        terms: [{
            duration: 5,
            operator: "below",
            priority: "critical",
            threshold: 0.75,
            timeFunction: "all",
        }],
    });
    
    import pulumi
    import pulumi_newrelic as newrelic
    
    app = newrelic.get_entity(name="my-app",
        type="APPLICATION",
        domain="APM")
    foo_alert_policy = newrelic.AlertPolicy("fooAlertPolicy")
    foo_alert_condition = newrelic.AlertCondition("fooAlertCondition",
        policy_id=foo_alert_policy.id,
        type="apm_app_metric",
        entities=[app.application_id],
        metric="apdex",
        runbook_url="https://www.example.com",
        condition_scope="application",
        terms=[newrelic.AlertConditionTermArgs(
            duration=5,
            operator="below",
            priority="critical",
            threshold=0.75,
            time_function="all",
        )])
    
    resources:
      fooAlertPolicy:
        type: newrelic:AlertPolicy
      fooAlertCondition:
        type: newrelic:AlertCondition
        properties:
          policyId: ${fooAlertPolicy.id}
          type: apm_app_metric
          entities:
            - ${app.applicationId}
          metric: apdex
          runbookUrl: https://www.example.com
          conditionScope: application
          terms:
            - duration: 5
              operator: below
              priority: critical
              threshold: 0.75
              timeFunction: all
    variables:
      app:
        Fn::Invoke:
          Function: newrelic:getEntity
          Arguments:
            name: my-app
            type: APPLICATION
            domain: APM
    

    Create AlertCondition Resource

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

    Constructor syntax

    new AlertCondition(name: string, args: AlertConditionArgs, opts?: CustomResourceOptions);
    @overload
    def AlertCondition(resource_name: str,
                       args: AlertConditionArgs,
                       opts: Optional[ResourceOptions] = None)
    
    @overload
    def AlertCondition(resource_name: str,
                       opts: Optional[ResourceOptions] = None,
                       type: Optional[str] = None,
                       entities: Optional[Sequence[int]] = None,
                       metric: Optional[str] = None,
                       policy_id: Optional[int] = None,
                       terms: Optional[Sequence[AlertConditionTermArgs]] = None,
                       enabled: Optional[bool] = None,
                       gc_metric: Optional[str] = None,
                       name: Optional[str] = None,
                       runbook_url: Optional[str] = None,
                       condition_scope: Optional[str] = None,
                       user_defined_metric: Optional[str] = None,
                       user_defined_value_function: Optional[str] = None,
                       violation_close_timer: Optional[int] = None)
    func NewAlertCondition(ctx *Context, name string, args AlertConditionArgs, opts ...ResourceOption) (*AlertCondition, error)
    public AlertCondition(string name, AlertConditionArgs args, CustomResourceOptions? opts = null)
    public AlertCondition(String name, AlertConditionArgs args)
    public AlertCondition(String name, AlertConditionArgs args, CustomResourceOptions options)
    
    type: newrelic:AlertCondition
    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 AlertConditionArgs
    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 AlertConditionArgs
    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 AlertConditionArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args AlertConditionArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args AlertConditionArgs
    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 alertConditionResource = new NewRelic.AlertCondition("alertConditionResource", new()
    {
        Type = "string",
        Entities = new[]
        {
            0,
        },
        Metric = "string",
        PolicyId = 0,
        Terms = new[]
        {
            new NewRelic.Inputs.AlertConditionTermArgs
            {
                Duration = 0,
                Threshold = 0,
                TimeFunction = "string",
                Operator = "string",
                Priority = "string",
            },
        },
        Enabled = false,
        GcMetric = "string",
        Name = "string",
        RunbookUrl = "string",
        ConditionScope = "string",
        UserDefinedMetric = "string",
        UserDefinedValueFunction = "string",
        ViolationCloseTimer = 0,
    });
    
    example, err := newrelic.NewAlertCondition(ctx, "alertConditionResource", &newrelic.AlertConditionArgs{
    	Type: pulumi.String("string"),
    	Entities: pulumi.IntArray{
    		pulumi.Int(0),
    	},
    	Metric:   pulumi.String("string"),
    	PolicyId: pulumi.Int(0),
    	Terms: newrelic.AlertConditionTermArray{
    		&newrelic.AlertConditionTermArgs{
    			Duration:     pulumi.Int(0),
    			Threshold:    pulumi.Float64(0),
    			TimeFunction: pulumi.String("string"),
    			Operator:     pulumi.String("string"),
    			Priority:     pulumi.String("string"),
    		},
    	},
    	Enabled:                  pulumi.Bool(false),
    	GcMetric:                 pulumi.String("string"),
    	Name:                     pulumi.String("string"),
    	RunbookUrl:               pulumi.String("string"),
    	ConditionScope:           pulumi.String("string"),
    	UserDefinedMetric:        pulumi.String("string"),
    	UserDefinedValueFunction: pulumi.String("string"),
    	ViolationCloseTimer:      pulumi.Int(0),
    })
    
    var alertConditionResource = new com.pulumi.newrelic.AlertCondition("alertConditionResource", com.pulumi.newrelic.AlertConditionArgs.builder()
        .type("string")
        .entities(0)
        .metric("string")
        .policyId(0)
        .terms(AlertConditionTermArgs.builder()
            .duration(0)
            .threshold(0.0)
            .timeFunction("string")
            .operator("string")
            .priority("string")
            .build())
        .enabled(false)
        .gcMetric("string")
        .name("string")
        .runbookUrl("string")
        .conditionScope("string")
        .userDefinedMetric("string")
        .userDefinedValueFunction("string")
        .violationCloseTimer(0)
        .build());
    
    alert_condition_resource = newrelic.AlertCondition("alertConditionResource",
        type="string",
        entities=[0],
        metric="string",
        policy_id=0,
        terms=[{
            "duration": 0,
            "threshold": 0,
            "time_function": "string",
            "operator": "string",
            "priority": "string",
        }],
        enabled=False,
        gc_metric="string",
        name="string",
        runbook_url="string",
        condition_scope="string",
        user_defined_metric="string",
        user_defined_value_function="string",
        violation_close_timer=0)
    
    const alertConditionResource = new newrelic.AlertCondition("alertConditionResource", {
        type: "string",
        entities: [0],
        metric: "string",
        policyId: 0,
        terms: [{
            duration: 0,
            threshold: 0,
            timeFunction: "string",
            operator: "string",
            priority: "string",
        }],
        enabled: false,
        gcMetric: "string",
        name: "string",
        runbookUrl: "string",
        conditionScope: "string",
        userDefinedMetric: "string",
        userDefinedValueFunction: "string",
        violationCloseTimer: 0,
    });
    
    type: newrelic:AlertCondition
    properties:
        conditionScope: string
        enabled: false
        entities:
            - 0
        gcMetric: string
        metric: string
        name: string
        policyId: 0
        runbookUrl: string
        terms:
            - duration: 0
              operator: string
              priority: string
              threshold: 0
              timeFunction: string
        type: string
        userDefinedMetric: string
        userDefinedValueFunction: string
        violationCloseTimer: 0
    

    AlertCondition 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 AlertCondition resource accepts the following input properties:

    Entities List<int>
    The instance IDs associated with this condition.
    Metric string
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    PolicyId int
    The ID of the policy where this condition should be used.
    Terms List<Pulumi.NewRelic.Inputs.AlertConditionTerm>
    A list of terms for this condition. See Terms below for details.
    Type string
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    ConditionScope string
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    Enabled bool
    Whether the condition is enabled or not. Defaults to true.
    GcMetric string
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    Name string
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    RunbookUrl string
    Runbook URL to display in notifications.
    UserDefinedMetric string
    A custom metric to be evaluated.
    UserDefinedValueFunction string
    One of: average, min, max, total, or sample_size.
    ViolationCloseTimer int
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.
    Entities []int
    The instance IDs associated with this condition.
    Metric string
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    PolicyId int
    The ID of the policy where this condition should be used.
    Terms []AlertConditionTermArgs
    A list of terms for this condition. See Terms below for details.
    Type string
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    ConditionScope string
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    Enabled bool
    Whether the condition is enabled or not. Defaults to true.
    GcMetric string
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    Name string
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    RunbookUrl string
    Runbook URL to display in notifications.
    UserDefinedMetric string
    A custom metric to be evaluated.
    UserDefinedValueFunction string
    One of: average, min, max, total, or sample_size.
    ViolationCloseTimer int
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.
    entities List<Integer>
    The instance IDs associated with this condition.
    metric String
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    policyId Integer
    The ID of the policy where this condition should be used.
    terms List<AlertConditionTerm>
    A list of terms for this condition. See Terms below for details.
    type String
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    conditionScope String
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    enabled Boolean
    Whether the condition is enabled or not. Defaults to true.
    gcMetric String
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    name String
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    runbookUrl String
    Runbook URL to display in notifications.
    userDefinedMetric String
    A custom metric to be evaluated.
    userDefinedValueFunction String
    One of: average, min, max, total, or sample_size.
    violationCloseTimer Integer
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.
    entities number[]
    The instance IDs associated with this condition.
    metric string
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    policyId number
    The ID of the policy where this condition should be used.
    terms AlertConditionTerm[]
    A list of terms for this condition. See Terms below for details.
    type string
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    conditionScope string
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    enabled boolean
    Whether the condition is enabled or not. Defaults to true.
    gcMetric string
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    name string
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    runbookUrl string
    Runbook URL to display in notifications.
    userDefinedMetric string
    A custom metric to be evaluated.
    userDefinedValueFunction string
    One of: average, min, max, total, or sample_size.
    violationCloseTimer number
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.
    entities Sequence[int]
    The instance IDs associated with this condition.
    metric str
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    policy_id int
    The ID of the policy where this condition should be used.
    terms Sequence[AlertConditionTermArgs]
    A list of terms for this condition. See Terms below for details.
    type str
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    condition_scope str
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    enabled bool
    Whether the condition is enabled or not. Defaults to true.
    gc_metric str
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    name str
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    runbook_url str
    Runbook URL to display in notifications.
    user_defined_metric str
    A custom metric to be evaluated.
    user_defined_value_function str
    One of: average, min, max, total, or sample_size.
    violation_close_timer int
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.
    entities List<Number>
    The instance IDs associated with this condition.
    metric String
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    policyId Number
    The ID of the policy where this condition should be used.
    terms List<Property Map>
    A list of terms for this condition. See Terms below for details.
    type String
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    conditionScope String
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    enabled Boolean
    Whether the condition is enabled or not. Defaults to true.
    gcMetric String
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    name String
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    runbookUrl String
    Runbook URL to display in notifications.
    userDefinedMetric String
    A custom metric to be evaluated.
    userDefinedValueFunction String
    One of: average, min, max, total, or sample_size.
    violationCloseTimer Number
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the AlertCondition 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 AlertCondition Resource

    Get an existing AlertCondition 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?: AlertConditionState, opts?: CustomResourceOptions): AlertCondition
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            condition_scope: Optional[str] = None,
            enabled: Optional[bool] = None,
            entities: Optional[Sequence[int]] = None,
            gc_metric: Optional[str] = None,
            metric: Optional[str] = None,
            name: Optional[str] = None,
            policy_id: Optional[int] = None,
            runbook_url: Optional[str] = None,
            terms: Optional[Sequence[AlertConditionTermArgs]] = None,
            type: Optional[str] = None,
            user_defined_metric: Optional[str] = None,
            user_defined_value_function: Optional[str] = None,
            violation_close_timer: Optional[int] = None) -> AlertCondition
    func GetAlertCondition(ctx *Context, name string, id IDInput, state *AlertConditionState, opts ...ResourceOption) (*AlertCondition, error)
    public static AlertCondition Get(string name, Input<string> id, AlertConditionState? state, CustomResourceOptions? opts = null)
    public static AlertCondition get(String name, Output<String> id, AlertConditionState state, CustomResourceOptions options)
    resources:  _:    type: newrelic:AlertCondition    get:      id: ${id}
    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:
    ConditionScope string
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    Enabled bool
    Whether the condition is enabled or not. Defaults to true.
    Entities List<int>
    The instance IDs associated with this condition.
    GcMetric string
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    Metric string
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    Name string
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    PolicyId int
    The ID of the policy where this condition should be used.
    RunbookUrl string
    Runbook URL to display in notifications.
    Terms List<Pulumi.NewRelic.Inputs.AlertConditionTerm>
    A list of terms for this condition. See Terms below for details.
    Type string
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    UserDefinedMetric string
    A custom metric to be evaluated.
    UserDefinedValueFunction string
    One of: average, min, max, total, or sample_size.
    ViolationCloseTimer int
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.
    ConditionScope string
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    Enabled bool
    Whether the condition is enabled or not. Defaults to true.
    Entities []int
    The instance IDs associated with this condition.
    GcMetric string
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    Metric string
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    Name string
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    PolicyId int
    The ID of the policy where this condition should be used.
    RunbookUrl string
    Runbook URL to display in notifications.
    Terms []AlertConditionTermArgs
    A list of terms for this condition. See Terms below for details.
    Type string
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    UserDefinedMetric string
    A custom metric to be evaluated.
    UserDefinedValueFunction string
    One of: average, min, max, total, or sample_size.
    ViolationCloseTimer int
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.
    conditionScope String
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    enabled Boolean
    Whether the condition is enabled or not. Defaults to true.
    entities List<Integer>
    The instance IDs associated with this condition.
    gcMetric String
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    metric String
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    name String
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    policyId Integer
    The ID of the policy where this condition should be used.
    runbookUrl String
    Runbook URL to display in notifications.
    terms List<AlertConditionTerm>
    A list of terms for this condition. See Terms below for details.
    type String
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    userDefinedMetric String
    A custom metric to be evaluated.
    userDefinedValueFunction String
    One of: average, min, max, total, or sample_size.
    violationCloseTimer Integer
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.
    conditionScope string
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    enabled boolean
    Whether the condition is enabled or not. Defaults to true.
    entities number[]
    The instance IDs associated with this condition.
    gcMetric string
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    metric string
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    name string
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    policyId number
    The ID of the policy where this condition should be used.
    runbookUrl string
    Runbook URL to display in notifications.
    terms AlertConditionTerm[]
    A list of terms for this condition. See Terms below for details.
    type string
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    userDefinedMetric string
    A custom metric to be evaluated.
    userDefinedValueFunction string
    One of: average, min, max, total, or sample_size.
    violationCloseTimer number
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.
    condition_scope str
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    enabled bool
    Whether the condition is enabled or not. Defaults to true.
    entities Sequence[int]
    The instance IDs associated with this condition.
    gc_metric str
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    metric str
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    name str
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    policy_id int
    The ID of the policy where this condition should be used.
    runbook_url str
    Runbook URL to display in notifications.
    terms Sequence[AlertConditionTermArgs]
    A list of terms for this condition. See Terms below for details.
    type str
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    user_defined_metric str
    A custom metric to be evaluated.
    user_defined_value_function str
    One of: average, min, max, total, or sample_size.
    violation_close_timer int
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.
    conditionScope String
    application or instance. Choose application for most scenarios. If you are using the JVM plugin in New Relic, the instance setting allows your condition to trigger for specific app instances.
    enabled Boolean
    Whether the condition is enabled or not. Defaults to true.
    entities List<Number>
    The instance IDs associated with this condition.
    gcMetric String
    A valid Garbage Collection metric e.g. GC/G1 Young Generation.
    metric String
    The metric field accepts parameters based on the type set. One of these metrics based on type:

    • apm_app_metric
    • apdex
    • error_percentage
    • response_time_background
    • response_time_web
    • throughput_background
    • throughput_web
    • user_defined
    • apm_jvm_metric
    • cpu_utilization_time
    • deadlocked_threads
    • gc_cpu_time
    • heap_memory_usage
    • apm_kt_metric
    • apdex
    • error_count
    • error_percentage
    • response_time
    • throughput
    • browser_metric
    • ajax_response_time
    • ajax_throughput
    • dom_processing
    • end_user_apdex
    • network
    • page_rendering
    • page_view_throughput
    • page_views_with_js_errors
    • request_queuing
    • total_page_load
    • user_defined
    • web_application
    • mobile_metric
    • database
    • images
    • json
    • mobile_crash_rate
    • network_error_percentage
    • network
    • status_error_percentage
    • user_defined
    • view_loading
    name String
    The title of the condition. Must be between 1 and 64 characters, inclusive.
    policyId Number
    The ID of the policy where this condition should be used.
    runbookUrl String
    Runbook URL to display in notifications.
    terms List<Property Map>
    A list of terms for this condition. See Terms below for details.
    type String
    The type of condition. One of: apm_app_metric, apm_jvm_metric, apm_kt_metric, browser_metric, mobile_metric
    userDefinedMetric String
    A custom metric to be evaluated.
    userDefinedValueFunction String
    One of: average, min, max, total, or sample_size.
    violationCloseTimer Number
    Automatically close instance-based violations, including JVM health metric violations, after the number of hours specified. Must be: 1, 2, 4, 8, 12 or 24.

    Supporting Types

    AlertConditionTerm, AlertConditionTermArgs

    Duration int
    Threshold double
    TimeFunction string
    Operator string
    Priority string
    Duration int
    Threshold float64
    TimeFunction string
    Operator string
    Priority string
    duration Integer
    threshold Double
    timeFunction String
    operator String
    priority String
    duration number
    threshold number
    timeFunction string
    operator string
    priority string
    duration Number
    threshold Number
    timeFunction String
    operator String
    priority String

    Import

    Alert conditions can be imported using notation alert_policy_id:alert_condition_id, e.g.

     $ pulumi import newrelic:index/alertCondition:AlertCondition main 123456:6789012345
    

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

    Package Details

    Repository
    New Relic pulumi/pulumi-newrelic
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the newrelic Terraform Provider.
    newrelic logo
    Viewing docs for New Relic v4.20.0 (Older version)
    published on Monday, Mar 9, 2026 by Pulumi
      Try Pulumi Cloud free. Your team will thank you.