使用Cassandra作为存储时Loki报错表index_XXXX不存在

按照Grafana官方文档指引，将Cassandra作为Grafana Loki的数据和索引存储，但启动后报错提示表'index_XXXX'不存在，检查了Docker Compose和Loki配置文件如下，求排查遗漏步骤。

提供的配置文件 #

Docker Compose配置 #

loki:
    image: grafana/loki:2.8.0
    ports:
      - 3100:3100
    volumes:
      - ./config/loki-config.yml:/etc/loki/local-config.yaml
    command: -config.file=/etc/loki/local-config.yaml
    depends_on:
      - cassandra
    networks:
      - app

Loki配置文件 #

target: all

auth_enabled: false

server:
  http_listen_port: 3100
  
common:
  path_prefix: /loki
  ring:
    kvstore:
      store: inmemory
  
schema_config:
  configs:
    - from: 2020-07-01
      store: cassandra
      object_store: cassandra
      schema: v11
      index:
        prefix: index_
        period: 168h
      chunks:
        prefix: chunk_
        period: 168h
  
storage_config:
  cassandra:
    addresses: cassandra
    keyspace: loki1
    auth: false
    replication_factor: 1
    timeout: 100s
    connect_timeout: 100s
    max_retries: 3
  filesystem:
    directory: /loki/chunks

table_manager:
  retention_deletes_enabled: true
  retention_period: 168h
  
limits_config:
  retention_period: 168h
  allow_deletes: true

排查与解决方案 #

• Cassandra键空间及表未初始化：Loki不会自动创建Cassandra的键空间和表，必须手动执行schema脚本初始化。
  操作步骤：

  1. 进入Cassandra容器：docker exec -it <你的Cassandra容器名称> cqlsh
  2. 创建指定键空间（如果尚未创建）：

     CREATE KEYSPACE loki1 WITH replication = {'class': 'SimpleStrategy', 'replication_factor': 1} AND durable_writes = true;
     

  3. 切换到目标键空间：USE loki1;
  4. 执行对应Loki版本的Cassandra schema建表脚本，脚本包含所有index和chunk相关表的创建语句。

• Table Manager未正常工作：当前配置中target: all已包含table-manager组件，但仍需确认：

  • Cassandra用户（如果开启认证）拥有创建表的权限
  • Loki启动时Cassandra已完全就绪（depends_on仅保证启动顺序，不保证服务可用，可在Loki启动前添加等待逻辑，比如循环用cqlsh测试连接）

• Schema时间范围验证：确认schema_config中的from时间（2020-07-01）早于当前时间，否则Loki不会为当前时间区间创建对应的表。当前配置的period: 168h为7天，时间范围无问题，但需确保系统时间正确。

内容的提问来源于stack exchange，提问作者lahirumw