> ## Documentation Index > Fetch the complete documentation index at: https://docs.odigos.io/llms.txt > Use this file to discover all available pages before exploring further. # OpenStack Swift S3 Gateway > Configuring the OpenStack Swift S3 Gateway backend (Self-Hosted) ### Getting Started ![openstackswift](https://d15jtxgb40qetw.cloudfront.net/openstackswift.svg) This destination archives traces, metrics and logs as OTLP JSON or protobuf objects in Swift. It does not provide native APM views, metric queries, log search, or profile storage. Download objects and decode them with OpenTelemetry pdata, or use a downstream pipeline that understands OTLP and the selected compression. **Deployment prerequisites** Enable Swift [s3api middleware](https://docs.openstack.org/swift/latest/middleware.html#aws-s3-api) on the actual proxy deployment. For Keystone authentication the pipeline must include `s3api`, `s3token`, and `keystoneauth`; include `bulk` and `slo` for multipart uploads. A deployment with only the native Swift API cannot accept this destination. Create an existing container/bucket and obtain Keystone EC2 credentials using the Horizon API Access panel or `openstack ec2 credentials create`. Use the EC2 access and secret keys in the destination's secret fields. A raw Swift token, Keystone password or application credential is not an S3 signing credential. Each destination has its own credential environment variables and S3 client. Set `S3_ENDPOINT` to the deployment's S3 base URL, not `/v1/AUTH_`. `S3_REGION` must match Swift's configured s3api location (commonly `us-east-1`). Path style is enabled by default; virtual-host addressing requires bucket DNS and matching TLS certificates. Prefer HTTPS. For a private CA, set `S3_CA_PEM`; certificate verification stays enabled. An explicit `http://` URL is suitable for local testing. **Data and delivery behavior** The upstream S3 exporter writes batches using unique object keys and retains OTLP resources, scopes, attributes and signal data in `otlp_json` or `otlp_proto`. All OpenTelemetry metric types are serialized; no conversion to Swift-native metrics occurs. Objects may be uncompressed, gzip or zstd compressed. Optional AWS SDK checksums are disabled for Swift compatibility; mandatory checksums remain enabled. The SDK retries transient S3 failures (three attempts by default), and the collector uses its sending queue and retry helper. Authentication errors and missing buckets prevent archival. S3 has no OTLP partial-success response: an upload either succeeds or fails, and multipart completion must succeed before its object is readable. Retries can create duplicate archive objects; this is not an exactly-once delivery guarantee. Check both upload and multipart behavior on your deployed middleware version and verify object download/decoding before relying on the archive. ### Configuring Destination Fields > [accordion] Supported Signals: > > ✅ Traces > ✅ Metrics > ✅ Logs > ❌ Profiles * **S3\_ENDPOINT** `string` : S3 Gateway Endpoint. S3 API base URL. Requires deployed s3api middleware; do not use the native Swift /v1/AUTH endpoint. * This field is required * Example: `https://swift.example.com` * **S3\_BUCKET** `string` : Bucket Name. Existing Swift container accessible through the S3 API. * This field is required * **S3\_REGION** `string` : Signing Region. Must match the location configured in Swift s3api. * This field is required and defaults to `us-east-1` * **S3\_ACCESS\_KEY\_ID** `string` : Keystone EC2 Access Key. Keystone EC2 credential access key, not a Swift token. * This field is required * **S3\_SECRET\_ACCESS\_KEY** `string` : Keystone EC2 Secret Key. * This field is required * **S3\_FORCE\_PATH\_STYLE** `string` : Use Path Style Addressing. Use path style unless the deployment supports bucket hostnames. * This field is optional and defaults to `true` * **S3\_CA\_PEM** `string` : Trusted CA Certificate. PEM CA certificate for an HTTPS endpoint signed by a private CA. TLS verification remains enabled. * This field is optional * **S3\_PARTITION\_FORMAT** `string` : Partition Format. * This field is optional * Example: `%Y/%m/%d/%H/%M` * **S3\_MARSHALER** `string` : Data Format. * This field is required and defaults to `otlp_json` * **S3\_COMPRESSION** `string` : Object Compression. * This field is optional and defaults to `none` ### Adding Destination to Odigos There are two primary methods for configuring destinations in Odigos: ##### **Using the UI** **Step 1** Use the [Odigos CLI](https://docs.odigos.io/cli/odigos_ui.md) to access the UI ```bash theme={null} odigos ui ``` **Step 2** Click on `Add Destination`, select `OpenStack Swift S3 Gateway` and follow the on-screen instructions ##### **Using Kubernetes manifests** **Step 1** Save the YAML below to a file (e.g. `openstackswift.yaml`) ```yaml theme={null} apiVersion: odigos.io/v1alpha1 kind: Destination metadata: name: openstackswift-example namespace: odigos-system spec: data: S3_BUCKET: S3_ENDPOINT: S3_MARSHALER: '' S3_REGION: '' # Note: The commented fields below are optional. # S3_FORCE_PATH_STYLE: # S3_CA_PEM: # S3_PARTITION_FORMAT: # S3_COMPRESSION: destinationName: openstackswift secretRef: name: openstackswift-secret signals: - TRACES - METRICS - LOGS type: openstackswift --- apiVersion: v1 data: S3_ACCESS_KEY_ID: S3_SECRET_ACCESS_KEY: kind: Secret metadata: name: openstackswift-secret namespace: odigos-system type: Opaque ``` **Step 2** Apply the YAML using `kubectl` ```bash theme={null} kubectl apply -f openstackswift.yaml ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.