Terraform provider release notes
To install the Terraform provider, see Install the Chronosphere Terraform provider.
Chronosphere supports the version 1.x.x line of Terraform provider versions for one year from their release dates. Be sure to use only a supported version, unless explicitly instructed otherwise by Chronosphere Support. If you experience issues, upgrade to the latest supported version.
Version 1.15.0
Released 2025.10.22
Feature
- Add
emit_metricsandreplace_fieldscontrol rule types tochronosphere_log_control_configresource. - Add
field_normalizationtochronosphere_log_ingest_configresource.
Released 2025.10.14
Feature
- Add
HOURLY_VOLUMEthreshold type tochronosphere_consumption_budgetresource. - Add
alert_action_configfield tochronosphere_consumption_budgetresource for customizing consumption budget alerts.
Version 1.14.0
Released 2025.10.02
Feature
- Add
azure_metrics_integrationresource for configuring the cloudscraper Azure metrics integration. - Add
modefield to thechronosphere_drop_ruleresource. This field replaces theactivefield, which is deprecated. The mode field accepts values ofenabled,disabled, andpreview. Defaults toenabled. Theactivefield wasdisabledby default. This is a breaking change.
Deprecations
- Deprecate the
activefield in thechronosphere_drop_ruleresource in favor of themodefield. This field can’t be set tofalse, and is a breaking change that requires switching to themodefield.
Version 1.13.0
Released 2025.08.27
Feature
- Add
chronosphere_log_control_configresource for configuring log control rules. - Replace
drop_originalwithkeep_originalin LogIngestConfig parser. - Promote
chronosphere_consumption_configresource from unstable to/v1. - Promote
chronosphere_consumption_budgetresource from unstable to/v1. - Add
span_tagfield tochronosphere_derived_labelresource.
Version 1.12.0
Released 2025.08.05
Feature
- Add unstable
chronosphere_consumption_configresource for configuring telemetry partitions. - Add unstable
chronosphere_consumption_budgetresource for configuring telemetry data budgets. - Update parsing support in
chronosphere_log_ingest_configresource.
Deprecations
- Deprecate
permissiveinchronosphere_rollup_ruleresource.
Version 1.11.0
Released 2025.05.15
Feature
- Add timeslice indicator support to
chronosphere_sloresource withcustom_timeslice_indicatorfield.
Version 1.10.0
Released 2025.04.24
Feature
- Promotes the
chronosphere_sloresource from unstable to v1 in the API.
Deprecations
- Removed queryless SLO fields from the unstable
chronosphere_sloresource. - Removed
reporting_windowsfrom the unstablechronosphere_sloresource.
Version 1.9.0
Released 2025.04.03
Features
- Add burn rate configs to the unstable
chronosphere_sloresource. - Add SLI level
additional_promql_filtersto the unstablechronosphere_sloresource.
Deprecation
- Deprecated queryless
additional_promql_filtersin unstablechronosphere_sloresource.
Version 1.8.0
Released 2025.02.28
Feature
- Adds
priority_thresholdstochronosphere_resource_pools_configpools.
Version 1.7.0
Released: 2025.02.13
Features
- Adds support for logging query in the
chronosphere_monitorresource. - Adds support for custom dimension labels in the
chronosphere_sloresource. - Add support for
is_root_spanfield in common trace span filter type. - Allow disabling dry-run validation using the provider configuration
disable_dryrun.
Fix
- Fix dry-run for
chronosphere_recording_rulewithbucket_slugandexecution_group.
Version 1.6.2
Released: 2024.12.18
This release contains no user-facing changes in behavior or function.
Version 1.6.1
Released: 2024.12.04
Fixes
- Fix
chronosphere_resource_pools_configerror when default pool isn’t set. Prior to this fix, the initial application of the configuration would succeed but then reading that configuration back would fail.
Version 1.6.0
Released: 2024.10.31
Features
- Adds support for
labelsinchronosphere_dashboard. - Allow
chronosphere_notification_policyresources without ateam_id.
Fix
- Support dry-run validation of Prometheus queries in a monitor that contain dynamic expressions, which aren’t known at plan time.
Version 1.5.1
Released: 2024.10.08
Fixes
- Allow creating
chronosphere_slack_notifierresources withactions, without theaction_confirm_textparameter. - Fixed an issue where applying a
chronosphere_rollup_ruleorchronosphere_mapping_ruleresource without a definedintervalorstorage_policycaused Terraform to continually detect a difference.
Version 1.5.0
Released: 2024.08.29
Feature
- Adds
fixed_valueinchronosphere_resource_pools_config.pools[].allocation, which lets you specify absolute DPPS per defined pool instead of as a percentage.
Deprecation
- Deprecates
allocationinchronosphere_resource_pools_config.default_pool. Thedefault_pool.allocationis now inferred to be any remaining quota unallocated across non-default pools.
Version 1.4.3
Released: 2024.07.29
Features
- Adds new
chronosphere_logscale_alertTerraform resource for creating LogScale alerts. - Adds new
chronosphere_logscale_actionTerraform resource for creating LogScale actions. - Adds new
chronosphere_otel_metrics_ingestionTerraform resource to configure how OpenTelemetry metrics are converted into Chronosphere format at ingestion.
Version 1.3.0
Released: 2024.07.09
This release contains no user-facing changes in behavior or function.
Version 1.2.0
Features
- Adds server-side validation support for
chronosphere_trace_metrics_rule. - Adds
group_bytonotification_routesinnotification_policyresources.
Version 1.1.0
Released: 2024.06.12
Feature
- Add server-side validation support for
chronosphere_trace_tail_sampling_rules
Deprecations
- Deprecates
proxy_urlin alert receivers. - Deprecates
chronosphere_mapping_rule.drop_timestamp.
Fix
- Fixes an issue where
chronosphere_resource_pools_configwould not allow certain combinations of allocation percents due to float arithmetic not adding to exactly 100 percent. The provider now relies on server-side validation of pools.
Version 1.0.0
Released: 2024.05.15
As of version 1.0.0, the Chronosphere Terraform provider is now open source and hosted on the public HashiCorp Terraform Registry (opens in a new tab).
Chronosphere has deprecated versions of the provider prior to 1.0.0 and no longer provides support for them. Upgrade to at least version 1.0.0 as soon as possible to continue receiving new features and fixes to the provider.
Legacy versions of the provider remain available on the Chronosphere-hosted Terraform registry. For instructions on installing older versions, see Install versions prior to v1.0.0.
This version removes deprecated and unsupported features. To avoid issues, review these release notes before upgrading.
Features
- Adds data source for
chronosphere_collection. - Adds support for
drop_nan_valueinchronosphere_drop_ruleresource. - Adds
chronosphere_gcp_metrics_integrationresource. - Adds
namefield tochronosphere_dashboardresource. - Adds new resource type,
chronosphere_dataset, for tracing dataset management. - Adds support for
graphite_label_policyinchronosphere_rollup_ruleresource. - Adds new
INandNOT_INsupport for tracing matchers.
Fix
- Fix
chronosphere_rollup_rulemigration fromstorage_policiestointerval.
Removals
- Prevents unsupported use of duplicate routes with the same severity in
chronosphere_notification_policy. - Removes unsupported
bucket_idinchronosphere_notification_policy. - Removes unsupported data source for
chronosphere_notification_policy. - Removes deprecated
rulesfield fromchronosphere_notification_policy. - Removes in-provider validation of rollup rules in favor of server-side dry run validation.
- Consolidates tracing schemas: Replace usage of
tagswithtag,min_secondswithmin_secs, andmax_secondswithmax_secs. - Removes support for setting a
chronosphere_dashboardresource’s name through thedashboard_json.metadata.namefield. - Removes deprecated resource
chronosphere_grafana_dashboardin favor ofchronosphere_classic_dashboard.
Deprecation
- Deprecates
chronosphere_rollup_rule.storage_policiesandchronosphere_mapping_rule.storage_policy, and recommendsinterval.
Unsupported versions
Click to view unsupported Terraform provider version release notes.
Version 0.46.0
Released: 2024.02.06
This release contains no user-facing changes in behavior or function.
Version 0.45.0
Released: 2024.01.18
Features
- Updates
chronosphere_collectionto maketeam_idoptional. - Adds
regexmatch type for trace metrics filters. - Adds
group_byfield tochronosphere_trace_metrics_ruleresource.
Version 0.44.0
Released: 2023.12.13
Features
- Adds new
chronosphere_servicedata source for services, which associates monitors with dashboards in service collections.
Version 0.43.0
Released: 2023.11.30
Features
- Adds new resource
chronosphere_classic_dashboard.
Version 0.42.0
Released: 2023.11.15
Features
- Adds support for the
resolve_sustainfield in monitor threshold conditions. - Adds
numeric_valuein span filter tags used inchronosphere_trace_tail_sampling_rulesandchronosphere_trace_metrics_ruleresources. - Adds the attributes
nameandsystem_nametochronosphere_trace_tail_sampling_rules. - Adds
chronotf import-stateownership transfers forchronosphere_resource_pools_config.
Fixes
- Fixes bug that caused
terraform planto fail when converting a notification policy from inline to independent.
Version 0.41.0
Released: 2023.09.28
This release contains no user-facing changes in behavior or function.
Version 0.40.0
Released: 2023.09.15
This release contains no user-facing changes in behavior or function.
Version 0.39.0
Released: 2023.09.05
Features
- Update a monitor when changing its
bucket_idinstead of forcibly deleting and recreating it.
Version 0.38.0
Released: 2023.08.28
Features
- Add
unrestricted,email, andslugsupport tochronosphere_service_account. - Add new required one_of between
unrestrictedandrestrictiontochronosphere_service_account. - Add support for the
descriptionfield on Teams. - Add a new enumerator
DISTRIBUTIONto the metric types for rollup rules.
Fixes
- Fix an unexpected diff after applying a notification policy in the
notification_policy_datafield. - Fix diff suppression for dashboard resource. JSON payload registers null and empty fields as equivalent.
Version 0.37.0
Released: 2023.07.26
Features
- Promote
Dashboardresource for general availability. - Add
Dashboardsupport tochronotf export-configandchronotf import-state.
Version 0.36.0
Released: 2023.06.23
Features
- Make
name_mappingsoptional forderived_labelresources. - Add
intervalfield tomapping_ruleandrollup_ruleresources. - Add
chronotf import-statesupport for Grafana dashboards. - Add
chronotf export-configsupport for Grafana dashboards with--include-grafana-dashboards, which exports dashboard JSON content to separate files.
Fixes
- Remove
one_ofbetweenservice_keyandrouting_keyfor PagerDuty notifiers.
Version 0.35.0
Released: 2023.05.10
Features
- Increase speed of reading from data source buckets.
- Hide Chronosphere-internal resources from
chronotf export-config. - Add support to update
bucket_idin place usingchronosphere_mapping_rule,chronosphere_recording_rule, andchronosphere_rollup_rule.
Fixes
- Fix
chronotf export-confignot exporting all buckets. - Fix
chronotf import-statetimeout errors when importing a large number of resources. - Support monitor schedules without any ranges.
Version 0.34.0
Released: 2023.04.07
Features
- Explicitly ask to set remote resource ownership to Terraform when running
chronotf import-stateinstead of changing ownership automatically. - Enable dry run validation support for Notifiers.
- Remove redundant logs from
chronotf import-stateoutput. - Enhance error messages by always showing HTTP verb, URL, status code, and body.
Fixes
- Allow Terraform updates to modify a notifier’s type instead of returning an error if the notifier’s type changed on the server.
- Display all HTTP error responses in the Chronosphere UI and API responses.
Version 0.33.0
Released: 2023.03.29
Feature
- Enable dry run validation support for collections, derived metrics, derived labels, drop rules, recording rules, teams, classic dashboards, and buckets.
Version 0.32.0
Released: 2023.03.23
Feature
- Import-state and export-config for ResourcePoolsConfig.
Version 0.31.0
Released: 2023.03.15
Feature
- Add support for managing derived labels, using the
chronosphere_derived_labelresource.
Version 0.30.0
Released: 2023.03.09
Feature
- Improved whitespace formatting in
chronotf export-config.
Version 0.29.0
Released: 2023.02.27
Features
- Enable dry run validation support for notification policies, mapping rules, and rollup rules.
- Add support to filter
chronotf export-configby slugs.
Fix
- Fix exporting of buckets with notification policies that have a mismatched slug.
Version 0.28.0
Released: 2023.02.03
Features
- Enable server-side dry run validation for monitor resources.
- Add system ownership support for mapping rules, roll-up rules, recording rules, and derived metrics. When Terraform creates or changes these objects, Chronosphere flags them as owned by Terraform and prevents overriding changes from other interfaces.
Version 0.27.0
Released: 2023.01.30
This release contains no user-facing changes in behavior or function.
Version 0.23.1
Released: 2022.11.29
Features
- Add support for managing service accounts, using the
chronosphere_service_accountresource. - Add support for managing multiple match rules, using the
chronosphere_resource_pools_configresource.
Fixes
chronotf export-configandimport-statecorrectly support all recording rules and roll-up rules.chronotf export-configcorrectly exports notification routes with an empty list of notifiers.- Conditional drop rules’ rate limit thresholds are now specified as percentage.
- Terraform plan stage validates usage of
routeandoverride. - Terraform plan stage warns about usage of deprecated features.
chronotf import-statecorrectly handles resources in modules.chronosphere_mapping_rulevalidates that at most one aggregation is specified.
Version 0.22.0
Released: 2022.10.11
Feature
- Improve formatting of drop rules when exporting configurations.
Fix
- Rename
value_based_drop_policytovalue_based_drop.
Version 0.21.0
Released: 2022.10.11
Feature
- Add support for value-based decisions in drop rules.
Fix
- Correctly import buckets nested in a module.
- Fix
chronotf import-statere-importing resources that are already managed by Terraform due to an unknown/updated field requiring the resource to be re-created.
Version 0.20.0
Released: 2022.09.27
Feature
- Drop empty fields when exporting email alert notifiers in
chronotf export-config.
Version 0.19.0
Released: 2022.09.07
Feature
- Add
permissivefield tochronosphere_rollup_ruleresources.
Fix
- Change
chronosphere_notification_policy.route.notifiersto a TypeSet to prevent ordering diffs. - Symmetrically export and import
chronosphere_notification_policyrepeat intervals.
Version 0.18.1
Released: 2022.08.23
Fix
- Don’t show unnecessary diffs for monitor conditions.
Version 0.18.0
Released: 2022.08.23
Features
- Add support for monitors that use a
NOT_EXISTScondition without a value. - Improve diffs to schedules in
chronosphere_monitorresources. - Improve diffs for changes to complex objects in a list, such as monitor schedules, mapping rule storage policies, and monitor label matchers.
Fixes
- Don’t show unnecessary diffs to empty labels on buckets.
- Don’t update the Terraform state on update errors.
- Remove incorrect log when importing notification policies with overrides.
Deprecation
chronosphere_notification_policy.ruleis now deprecated. Userouteinstead.
Version 0.17.0
Released: 2022.07.26
Feature
- Add support for monitors using an
EXISTScondition without a value.
Fixes
- Fix notification policy bugs that report changes immediately after an apply.
- Fix
activated_drop_durationin drop rules showing unexpected changes after an apply.
Version 0.16.0
Released: 2022.06.21
Features
- Add support for managing teams, using the
chronosphere_teamresource. - Add support for slug in all notifiers.
- Add support for slug in buckets.
- Add support for slug-based matching in
chronotf import-statefor monitors, teams, drop rules, mapping rules, roll-up rules, and all notifiers. - Make
storage_policiesoptional for roll-up rules. - Add support for
DELTAroll-up rules without a new metric name.
Fix
- Handle 404 as success when attempting to delete an already-deleted resource.
Version 0.15.0
Released: 2022.05.10
Features
- Add support for
drop_rawwith roll-up rules. - Add support for
slugwithchronosphere_bucketresources.
Version 0.14.1
Released: 2022.04.26
Fix
- Fix an issue with webhook notifiers using
bearer_token.
Version 0.14.0
Feature
- Recording rules now support independent specification of the target
metric_name. - Add support for
repeat_intervalin thechronosphere_notification_policyresource. chronotfnow handles exporting drop rule configuration.
Fixes
- Correctly handle the case of a notification policy introduced using the UI.
Version 0.13.0
Feature
- Add support for new resources for distributed tracing.
Version 0.12.0
Released: 2022.03.11
Features
- Provider registry hosting moved to
tf-registry.chronosphere.io. - Add support for importing and exporting mapping rules.
Version 0.11.0
Released: 2022.02.24
Fixes
- Fix an issue sending
chronosphere_export_jobon updates.
Version 0.10.0
Released: 2022.02.17
Feature
- Add support for managing mapping rules, using the
chronosphere_mapping_ruleresource.
Version 0.9.0
Released: 2022.02.03
Features
- Allow selecting a notification policy for a monitor independent of the bucket.
- Add support for new stat namespace in
chronosphere_export_jobresource.
Fixes
- Import and export support for buckets without a notification policy.
Version 0.8.0
Released: 2022.01.27
Features
- Add support for managing drop rules, using the
chronosphere_drop_ruleresource. - Add support for specifying durations in Prometheus format (support for d/w/y suffixes).
Fixes
- Fix panic when org name is incorrectly specified.
- Fix
chronotf import-stateerrors regarding unresolved references with recent versions of Terraform.
Version 0.7.0
Released: 2021.12.17
Feature
- Add support for VictorOps alert notifications.
Fixes
- Correctly handle converting Chronosphere slugs to Terraform IDs. Escape strings to support quotes and other special characters.
Version 0.6.0
Released: 2021.11.12
Feature
- Add support for managing Opsgenie notifiers, using the
chronotf export-configresource.
Fixes
- Fix an issue where objects deleted outside of Terraform caused the provider to error out.
- Fix a bug with marshalling attributes with special characters (like quotes)
for
chronotf export-config. - Fix incorrect output when marshalling a PagerDuty notifier using a RoutingKey
in
chronotf export-config. - Fix incorrect terraform IDs in the output of
chronotf export-config.
Version 0.5.3
Released: 2021.10.28
Feature
- Add support for managing roll-up rules, using the
chronosphere_rollup_ruleresource.
Version 0.5.2
Released: 2021.10.14
Fixes
- Fix escaping of quotes for
chronotf export-config.
Version 0.5.1
Released: 2021.10.14
Feature
- Add support for managing recording rules, using the
chronosphere_recording_ruleresource.