docker-zipkin

已归档

本仓库已归档，其功能已合并至[***]

概述

本仓库原包含Zipkin Server的Docker构建定义和发布流程，同时包含传输和存储后端（如Kafka或Cassandra）的测试镜像。

自动构建的镜像可在Quay.io的OpenZipkin组织下获取，并镜像至Docker Hub。

关于生产使用

OpenZipkin仅提供以下镜像用于生产环境：

• openzipkin/zipkin：核心服务器镜像，包含Zipkin UI、API和Collector功能。
• openzipkin/zipkin-slim：精简版服务器镜像，包含Zipkin UI和API功能，但仅支持内存或Elasticsearch存储，以及HTTP或gRPC跨度收集器。
• openzipkin/zipkin-dependencies：预聚合数据，使[***]

如果使用这些镜像时遇到问题，请提交issue或加入gitter。

此处的其他镜像和docker-compose配置仅用于开发和探索目的。例如，它们旨在帮助您集成整个Zipkin系统进行测试，无需了解所有工作原理，也无需下载千兆字节的文件。

例如，openzipkin/zipkin-cassandra并非为实际使用设计。您会发现它无法配置为运行多个节点，也无法像“实际环境”那样处理文件系统。我们期望生产用户使用存储或传输（如Kafka）的标准镜像，只有测试或学***Zipkin的用户才使用此处提供的镜像。

运行

Zipkin无依赖项，例如您可以运行内存中的Zipkin服务器： docker run -d -p 9411:9411 openzipkin/zipkin-slim

在(docker ip):9411查看UI。

在UI中，点击“zipkin-server”，然后点击“Find Traces”。

配置

配置通过环境变量进行，由zipkin-server定义。值得注意的是，您需要关注STORAGE_TYPE环境变量，其值包括“cassandra”、“mysql”和“elasticsearch”。

注意：openzipkin/zipkin-slim镜像仅支持“elasticsearch”存储。要使用其他存储类型，必须使用主镜像openzipkin/zipkin。

在Docker环境中，以下环境变量同样适用：

• JAVA_OPTS：用于设置Java参数，如堆大小或信任存储位置。
• STORAGE_PORT_9042_TCP_ADDR——监听9042端口的Cassandra节点。此环境变量通常通过将运行zipkin-cassandra的容器链接为“storage”来设置。
• STORAGE_PORT_3306_TCP_ADDR——监听3306端口的MySQL节点。此环境变量通常通过将运行zipkin-mysql的容器链接为“storage”来设置。
• STORAGE_PORT_9200_TCP_ADDR——监听9200端口的Elasticsearch节点。此环境变量通常通过将运行zipkin-elasticsearch的容器链接为“storage”来设置。当设置ES_HOSTS或ES_AWS_DOMAIN时，此变量将被忽略。
• KAFKA_PORT_2181_TCP_ADDR——监听2181端口的ZooKeeper节点。此环境变量通常通过将运行zipkin-kafka的容器链接为“kafka”来设置。

例如，要添加调试日志，可按docker-compose文件中的方式设置JAVA_OPTS：

yaml
      - JAVA_OPTS=-Dlogging.level.zipkin=DEBUG -Dlogging.level.zipkin2=DEBUG

运行时用户

openzipkin/zipkin和openzipkin/zipkin-slim镜像在名为“zipkin”的nologin用户下运行，主目录为“/zipkin”。由于这是无发行版镜像，不会安装许多工具，但您可以通过以下方式使用shell浏览内容：

bash
$ docker run -it --rm --entrypoint /busybox/sh openzipkin/zipkin
/zipkin $ ls
BOOT-INF  META-INF  org       run.sh

docker-compose

本项目配置为使用docker-compose运行Docker容器。注意，默认配置需要docker-compose 1.6.0+和docker-engine 1.10.0+。

要启动默认的docker-compose配置，运行：

$ docker-compose up

在$(docker ip):9411查看Web UI。

要在UI中查看特定跟踪，在下拉菜单中选择“zipkin-server”，然后点击“Find Traces”按钮。

精简版（Slim）

要启动更小、更快的Zipkin发行版，运行：

bash
$ docker-compose -f docker-compose-slim.yml up

此配置启动内存存储。精简版唯一支持的其他存储选项是Elasticsearch：

bash
$ docker-compose -f docker-compose-slim.yml -f docker-compose-elasticsearch.yml up

MySQL

docker-compose.yml中定义的默认docker-compose配置由MySQL支持。此配置在各自的容器中启动zipkin、zipkin-mysql和zipkin-dependencies（ cron作业）。

Cassandra

可使用docker-compose-cassandra.yml文件扩展docker-compose配置，以使用Cassandra替代MySQL。该文件使用docker-compose覆盖配置来替换存储容器。

要启动Cassandra支持的配置，运行：

$ docker-compose -f docker-compose.yml -f docker-compose-cassandra.yml up

Elasticsearch

可使用docker-compose-elasticsearch.yml文件扩展docker-compose配置，以使用Elasticsearch替代MySQL。该文件使用docker-compose覆盖配置来替换存储容器。

要启动Elasticsearch支持的配置，运行：

$ docker-compose -f docker-compose.yml -f docker-compose-elasticsearch.yml up

Elasticsearch 5+和主机设置

zipkin-elasticsearch5和zipkin-elasticsearch6镜像对虚拟内存有更严格的要求。您需要相应调整（尤其是注意Elasticsearch是否崩溃！）

bash
# 如果Docker在主机上运行，直接调整内核设置
$ sudo sysctl -w vm.max_map_count=262144

# 如果使用docker-machine/Docker Toolbox/Boot2Docker，远程调整相同设置
$ docker-machine ssh default "sudo sysctl -w vm.max_map_count=262144"

Kafka

可使用docker-compose-kafka.yml文件扩展docker-compose配置，以托管测试Kafka代理并激活Kafka收集器。该文件使用docker-compose覆盖配置添加Kafka+ZooKeeper容器和相关设置。

要启动MySQL+Kafka配置，运行：

$ docker-compose -f docker-compose.yml -f docker-compose-kafka.yml up

然后使用host.docker.internal:9092作为bootstrapServers值配置Kafka发送器（如果应用程序在同一Docker网络中），或使用localhost:***（如果不在同一网络但在同一主机上）。

换句话说，如果您在笔记本电脑上运行示例应用程序，将使用localhost:***作为引导服务器，将跟踪发送到Docker中运行的Kafka代理。

UI

可使用docker-compose-ui.yml文件扩展docker-compose配置，以在80端口托管UI。该文件使用docker-compose覆盖配置添加NGINX容器和相关设置。

要启动NGINX配置，运行：

$ docker-compose -f docker-compose.yml -f docker-compose-ui.yml up

此容器同时作为围绕Zipkin创建代理配置的框架，如身份验证、处理zipkin-js应用的CORS或终止SSL。

Prometheus

Zipkin内置Prometheus指标导出器。主docker-compose.yml文件启动配置为抓取Zipkin的Prometheus，暴露在9090端口。您可以打开$DOCKER_HOST_IP:9090并开始浏览指标（Zipkin的/prometheus端点提供指标）。

docker-compose.yml还启动禁用身份验证的Grafana容器，暴露在3000端口。启动时，它将docker-compose启动的Prometheus实例配置为数据源，并导入[***]docker-compose up后，您可以打开$DOCKER_IP:3000/dashboard/db/zipkin-prometheus并使用仪表板。

如果要针对远程Zipkin服务器独立运行zipkin-ui，需要相应设置ZIPKIN_BASE_URL：

bash
$ docker run -d -p 80:80 \
  -e ZIPKIN_BASE_URL=[***] \
  openzipkin/zipkin-ui

遗留内容

Docker Machine和Kafka

如果使用Docker Machine，调整docker-compose-kafka.yml中的KAFKA_ADVERTISED_HOST_NAME和Kafka发送器的bootstrapServers配置，以匹配Docker主机IP（例如192.168.99.100:***）。

注意事项

如果使用提供的MySQL服务器或镜像，请确保模式和其他参数与文档匹配。