Loki Configuration Examples

  1. Complete Local Config
  2. Google Cloud Storage
  3. Cassandra Index
  4. AWS

Complete Local config

  1. auth_enabled: false
  3. server:
  4.   http_listen_port: 3100
  6. ingester:
  7.   lifecycler:
  8.     address: 127.0.0.1
  9.     ring:
  10.       kvstore:
  11.         store: inmemory
  12.       replication_factor: 1
  13.     final_sleep: 0s
  14.   chunk_idle_period: 5m
  15.   chunk_retain_period: 30s
  17. schema_config:
  18.   configs:
  19.   - from: 2018-04-15
  20.     store: boltdb
  21.     object_store: filesystem
  22.     schema: v9
  23.     index:
  24.       prefix: index_
  25.       period: 168h
  27. storage_config:
  28.   boltdb:
  29.     directory: /tmp/loki/index
  31.   filesystem:
  32.     directory: /tmp/loki/chunks
  34. limits_config:
  35.   enforce_metric_name: false
  36.   reject_old_samples: true
  37.   reject_old_samples_max_age: 168h
  39. chunk_store_config:
  40.   max_look_back_period: 0
  42. table_manager:
  43.   chunk_tables_provisioning:
  44.     inactive_read_throughput: 0
  45.     inactive_write_throughput: 0
  46.     provisioned_read_throughput: 0
  47.     provisioned_write_throughput: 0
  48.   index_tables_provisioning:
  49.     inactive_read_throughput: 0
  50.     inactive_write_throughput: 0
  51.     provisioned_read_throughput: 0
  52.     provisioned_write_throughput: 0
  53.   retention_deletes_enabled: false
  54.   retention_period: 0

Google Cloud Storage

This is partial config that uses GCS and Bigtable for the chunk and indexstores, respectively.

  1. schema_config:
  2.   configs:
  3.   - from: 2018-04-15
  4.     store: bigtable
  5.     object_store: gcs
  6.     schema: v9
  7.     index:
  8.       prefix: loki_index_
  9.       period: 168h
  11. storage_config:
  12.   bigtable:
  13.     instance: BIGTABLE_INSTANCE
  14.     project: BIGTABLE_PROJECT
  15.   gcs:
  16.     bucket_name: GCS_BUCKET_NAME

Cassandra Index

This is a partial config that uses the local filesystem for chunk storage andCassandra for the index storage:

  1. schema_config:
  2.   configs:
  3.   - from: 2018-04-15
  4.     store: cassandra
  5.     object_store: filesystem
  6.     schema: v9
  7.     index:
  8.       prefix: cassandra_table
  9.       period: 168h
  11. storage_config:
  12.   cassandra:
  13.     username: cassandra
  14.     password: cassandra
  15.     addresses: 127.0.0.1
  16.     auth: true
  17.     keyspace: lokiindex
  19.   filesystem:
  20.     directory: /tmp/loki/chunks

AWS

This is a partial config that uses S3 for chunk storage and DynamoDB for theindex storage:

  1. schema_config:
  2.   configs:
  3.     - from: 2018-04-15
  4.       store: dynamo
  5.       object_store: s3
  6.       schema: v9
  7.       index:
  8.         prefix: dynamodb_table_name
  9.         period: 0
  10. storage_config:
  11.   aws:
  12.     s3: s3://access_key:secret_access_key@region/bucket_name
  13.     dynamodbconfig:
  14.       dynamodb: dynamodb://access_key:secret_access_key@region

If you don’t wish to hard-code S3 credentials, you can also configure an EC2instance role by changing the storage_config section:

  1. storage_config:
  2.   aws:
  3.     s3: s3://region/bucket_name
  4.     dynamodbconfig:
  5.       dynamodb: dynamodb://region

S3-compatible APIs

S3-compatible APIs (e.g., Ceph Object Storage with an S3-compatible API) can beused. If the API supports path-style URL rather than virtual hosted bucketaddressing, configure the URL in storage_config with the custom endpoint:

  1. storage_config:
  2.   aws:
  3.     s3: s3://access_key:secret_access_key@custom_endpoint/bucket_name
  4.     s3forcepathstyle: true