Observe Provider

The Observe provider allows you to interact with resources supported by Observe.

Example Usage

terraform {
  required_providers {
    observe = {
      source  = "terraform.observeinc.com/observeinc/observe"
      version = "~> 0.11"

# Configure the observe provider
provider "observe" {}

# Look up existing workspace 
data "observe_workspace" "default" {
  name = "Default"

Authentication and Configuration

You must provide a customer ID and valid credentials in order to interact with the Observe API.

Furthermore, you must configure the proper domain value based on where your observe tenant is deployed. See Observe Regions to determine the proper value for your Observe domain.

The provider can either be configured explicitly through parameters or through environment variables. Explicit configuration always takes precedence over environment variables:

provider "observe" {
  customer      = "123456789012"
  user_email    = "[email protected]"
  user_password = "secret"
  domain        = "observeinc.com"
provider "observe" {
  customer  = "123456789012"
  api_token = "2xxXXx7Xxxxx9Xxxx7xX_xXxX3Xx3XX_"
  domain    = "observeinc.com"

Every parameter in the provider schema has a corresponding environment variable composed by prefixing the upper-cased parameter name with OBSERVE_:

export OBSERVE_CUSTOMER=123456789012
export OBSERVE_USER_EMAIL=[email protected]
export OBSERVE_DOMAIN=observeinc.com
terraform plan
export OBSERVE_CUSTOMER=123456789012
export OBSERVE_API_TOKEN=2xxXXx7Xxxxx9Xxxx7xX_xXxX3Xx3XX_
export OBSERVE_DOMAIN=observeinc.com
terraform plan



  • customer (String) Your Observe Customer ID.


  • api_token (String, Sensitive) An Observe API Token. Used for authenticating requests to API in the absence of user_email and user_password.

  • domain (String) Observe API domain. Defaults to observeinc.com.

  • flags (String) Toggle experimental features.

  • http_client_timeout (String) HTTP client timeout. Defaults to 2m.

  • insecure (Boolean) Skip TLS certificate validation.

  • managing_object_id (String) ID of an Observe object that serves as the parent (managing) object for all resources created by the provider (internal use).

  • retry_count (Number) Maximum number of retries on temporary network failures. Defaults to 3.

  • retry_wait (String) Time between retries. Defaults to 3s.

  • source_comment (String) Source identifier comment. If null, fallback to user_email.

  • source_format (String) Source identifier format.

  • user_email (String) User email. If supplied, user_password is also required.

  • user_password (String, Sensitive) Password for provided user_email.


Data Sources