logzio/logzio-pubsub

镜像概述

该Docker镜像提供Google Cloud Platform (GCP)与Logz.io的集成能力，通过GCP Pubsub服务实现数据和日志从GCP环境向Logz.io的传输与管理，简化云环境日志分析流程。

核心功能与特性

• 支持GCP Pubsub消息订阅与消费，实时获取GCP环境中的数据
• 数据格式转换与处理，确保与Logz.io接收格式兼容
• 安全的Logz.io数据传输，支持TLS加密
• 可配置的消息处理策略，包括重试机制和错误处理
• 轻量级设计，资源占用低，易于部署和维护

使用场景与适用范围

• GCP环境中需要将日志、监控数据或事件数据发送至Logz.io进行集中分析的场景
• 云原生应用的日志聚合与传输
• 需要实时数据管道连接GCP与Logz.io的企业级应用

使用方法与配置说明

前提条件

• 已创建GCP项目并启用Pubsub服务
• 已创建Pubsub订阅（需确保有权限访问）
• 已获取Logz.io账户及API令牌

Docker Run命令示例

bash
docker run -d \
  --name gcp-pubsub-logzio \
  -e GCP_PROJECT_ID="your-gcp-project-id" \
  -e PUBSUB_SUBSCRIPTION_NAME="your-subscription-name" \
  -e LOGZIO_TOKEN="your-logzio-api-token" \
  -e LOGZIO_REGION="us" \  # 可选，默认us，其他可选eu、au等
  -e MESSAGE_PROCESSING_TIMEOUT=30 \  # 可选，消息处理超时时间(秒)，默认30
  gcr.io/logzio/gcp-pubsub-logzio:latest

环境变量配置说明

Docker Compose配置示例

yaml
version: '3'
services:
  gcp-pubsub-logzio:
    image: ***-gcr.xuanyuan.run/logzio/gcp-pubsub-logzio:latest
    container_name: gcp-pubsub-logzio
    environment:
      - GCP_PROJECT_ID=your-gcp-project-id
      - PUBSUB_SUBSCRIPTION_NAME=your-subscription-name
      - LOGZIO_TOKEN=your-logzio-api-token
      - LOGZIO_REGION=us
      - MESSAGE_PROCESSING_TIMEOUT=30
      - MAX_RETRIES=3
      - LOG_LEVEL=info
    restart: unless-stopped

注意事项

• 确保容器具有访问GCP Pubsub的权限，可通过挂载GCP服务账号密钥文件或配置环境变量GOOGLE_APPLICATION_CREDENTIALS指向密钥文件路径
• 对于高吞吐量场景，建议调整MESSAGE_PROCESSING_TIMEOUT和MAX_RETRIES参数以优化性能
• 定期更新镜像以获取最新功能和安全修复