dcm4che/logstash-dcm4chee

logstash-dcm4chee Docker镜像

概述

logstash-dcm4chee是专为dcm4che-arc 5.x归档服务器设计的Logstash Docker镜像。它提供了预配置的Logstash管道，用于收集、处理和转发dcm4chee归档服务器生成的审计日志和访问日志，实现***影像系统的集中式日志管理、分析和可视化。

核心功能与特性

• 预配置Logstash管道，支持dcm4chee审计日志和访问日志的解析
• 支持将处理后的日志发送到Elasticsearch进行存储和索引
• 提供默认的日志过滤规则和字段映射
• 支持环境变量配置，便于自定义部署
• 基于官方Logstash镜像构建，确保稳定性和安全性
• 包含示例Kibana仪表板，用于日志可视化和分析

使用场景与适用范围

• dcm4chee 5.x归档服务器的日志集中管理
• ***影像系统的审计跟踪和合规性监控
• DICOM服务访问模式分析
• 系统性能监控和故障排查
• ***数据访问安全审计
• 符合HIPAA等数据隐私的日志管理需求

使用方法与配置说明

环境变量配置

Docker Run示例

bash
docker run -d \
  --name logstash-dcm4chee \
  -p 5000:5000 \
  -p 5000:5000/udp \
  -e ELASTICSEARCH_HOST=my-elasticsearch \
  -e ELASTICSEARCH_PORT=9200 \
  -e ELASTICSEARCH_USER=logstash_user \
  -e ELASTICSEARCH_PASSWORD=secure_password \
  dcm4che/logstash-dcm4chee:latest

Docker Compose示例

yaml
version: '3'
services:
  logstash:
    image: dcm4che/logstash-dcm4chee:latest
    container_name: logstash-dcm4chee
    ports:
      - "5000:5000"
      - "5000:5000/udp"
    environment:
      - ELASTICSEARCH_HOST=elasticsearch
      - ELASTICSEARCH_PORT=9200
      - ELASTICSEARCH_USER=elastic
      - ELASTICSEARCH_PASSWORD=changeme
      - AUDIT_LOG_INDEX=dcm4chee-audit
      - ACCESS_LOG_INDEX=dcm4chee-access
    depends_on:
      - elasticsearch
    networks:
      - dcm4chee-network

  elasticsearch:
    image: docker.elastic.co/elasticsearch/elasticsearch:7.14.0
    container_name: elasticsearch
    environment:
      - discovery.type=single-node
      - "ES_JAVA_OPTS=-Xms512m -Xmx512m"
      - ELASTIC_PASSWORD=changeme
    ports:
      - "9200:9200"
    networks:
      - dcm4chee-network

networks:
  dcm4chee-network:
    driver: bridge

日志输入配置

logstash-dcm4chee支持以下日志输入方式：

1. TCP输入：默认端口5000，用于接收结构化日志
2. UDP输入：默认端口5000，用于接收简单日志消息
3. 文件输入：可通过挂载日志目录进行配置

与dcm4chee集成

要将dcm4chee归档服务器的日志发送到logstash-dcm4chee，需要在dcm4chee配置中设置适当的日志输出：

properties
# dcm4chee audit log configuration
audit.logger.destination=logstash-host:5000
audit.logger.protocol=tcp
audit.logger.format=json

# dcm4chee access log configuration
access.logger.destination=logstash-host:5000
access.logger.protocol=udp
access.logger.format=json

自定义配置

如需自定义Logstash管道配置，可以通过挂载配置文件到容器的/usr/share/logstash/pipeline/目录：

bash
docker run -d \
  --name logstash-dcm4chee \
  -v /path/to/custom/pipeline:/usr/share/logstash/pipeline/ \
  dcm4che/logstash-dcm4chee:latest

维护与支持

• 官方GitHub仓库：https://github.com/dcm4che-dockerfiles/logstash-dcm4chee
• 问题反馈：https://github.com/dcm4che-dockerfiles/logstash-dcm4chee/issues
• 社区支持：[***]
• 商业支持：[***]