Apache Polaris、Prometheus 和 Jaeger 快速入门

本示例要求您的机器上已安装 jq。

1. 如果本地尚未存在 Polaris 镜像，请先构建该镜像：

   ./gradlew \
     :polaris-server:assemble \
     :polaris-server:quarkusAppPartsBuild --rerun \
     -Dquarkus.container-image.build=true

2. 在代码库根目录下运行以下命令，启动 docker compose 服务组：

   docker compose -f getting-started/telemetry/docker-compose.yml up

3. 若要从宿主机访问 Polaris，请先请求访问令牌：

   export POLARIS_TOKEN=$(curl -s http://localhost:8181/api/catalog/v1/oauth/tokens \
      --user root:s3cr3t \
      -d 'grant_type=client_credentials' \
      -d 'scope=PRINCIPAL_ROLE:ALL' | jq -r .access_token)

4. 然后，在访问 Polaris 时于 Authorization 请求头中使用该访问令牌；您也可以测试 X-Request-ID 请求头——您应当能在所有日志和链路追踪中看到它：

   curl -v 'http://localhost:8181/api/management/v1/principal-roles' \
     -H "Authorization: Bearer $POLARIS_TOKEN" \
     -H "X-Request-ID: 1234"
   curl -v 'http://localhost:8181/api/catalog/v1/config?warehouse=quickstart_catalog' \
     -H "Authorization: Bearer $POLARIS_TOKEN" \
     -H "X-Request-ID: 5678"

5. 访问以下服务：

   • Prometheus UI：浏览 http://localhost:9093 查看指标。
   • Jaeger UI：浏览 http://localhost:16686 查看链路追踪。