ionoscloud_logging_pipeline

Creates and manages Logging pipeline objects.

Manages a Logging pipeline.

⚠️ Only tokens are accepted for authorization in the logging_pipeline resource. Please ensure you are using tokens as other methods will not be valid.

Usage example

resource "ionoscloud_logging_pipeline" "example" {
  location = "es/vit"
  name = "pipelineexample"
  log {
    source = "kubernetes"
    tag = "tagexample"
    protocol = "http"
    destinations {
      type = "loki"
      retention_in_days = 7
    }
  }
  log {
    source = "kubernetes"
    tag = "anothertagexample"
    protocol = "tcp"
    destinations {
      type = "loki"
      retention_in_days = 7
    }
  }
}

For re-usability, an array of logs can be defined in a tfvars file or inside the terraform plan, and used as presented below:

The content inside vars.tfvars file:

logs = [
  {
    source = "kubernetes"
    tag = "firstlog"
    protocol = "http"
    destinations = {
      type = "loki"
      retention_in_days = 7
    }},
    {
    source = "docker"
    tag = "secondlog"
    protocol = "tcp"
    destinations = {
      type = "loki"
      retention_in_days = 14
    }}]

The content inside the tf plan:

variable "logs" {
  description = "logs"
  type        = list(object({
    source = string
    tag = string
    protocol = string
    destinations = object({
      type = string
      retention_in_days = number
    } )}))
}

resource "ionoscloud_logging_pipeline" "example" {
  location = "es/vit"
  name = "examplepipeline"
  dynamic "log" {
    for_each = var.logs
    content {
      source = log.value["source"]
      tag = log.value["tag"]
      protocol = log.value["protocol"]
      destinations {
        type = log.value["destinations"]["type"]
        retention_in_days = log.value["destinations"]["retention_in_days"]
      }
    }
  }
}

The configuration can then be applied using the following commands:

terraform plan -var-file="vars.tfvars"
terraform apply -var-file="vars.tfvars"

Argument reference

• location - (Optional)[string] The location of the Logging pipeline. Default: de/txl, other available locations: de/fra, de/fra/2, de/txl, es/vit, gb/bhx, gb/lhr, fr/par, us/mci. If this is not set and if no value is provided for the IONOS_API_URL env var, the default location will be: de/fra.

• name - (Required)[string] The name of the Logging pipeline.

• grafana_address - (Computed)[string] The Grafana address is where user can access their logs, create dashboards, and set up alerts

• tcp_address - (Computed)[string] The TCP address of the pipeline. This is the address to which logs are sent using the TCP protocol.

• http_address - (Computed)[string] The HTTP address of the pipeline. This is the address to which logs are sent using the HTTP protocol.

• log - (Required)[list] Pipeline logs, a list that contains elements with the following structure:

  • source - (Required)[string] The source parser to be used.

  • tag - (Required)[string] The tag is used to distinguish different pipelines. Must be unique amongst the pipeline's array items.

  • protocol - (Required)[string] "Protocol to use as intake. Possible values are: http, tcp."

  • destinations - (Optional)[list] The configuration of the logs datastore, a list that contains elements with the following structure:

    • type - (Optional)[string] The internal output stream to send logs to.

    • retention_in_days - (Optional)[int] Defines the number of days a log record should be kept in loki. Works with loki destination type only. Can be one of: 7, 14, 30.

• key - (Computed)[string] The key is shared once and is used to authenticate the logs sent to the pipeline

Import

In order to import a Logging pipeline, you can define an empty Logging pipeline resource in the plan:

resource "ionoscloud_logging_pipeline" "example" {
}

The resource can be imported using the location and pipeline_id, for example:

terraform import ionoscloud_logging_pipeline.example location:pipeline_id