krish512/ambassador_logservice_es

Ambassador Elasticsearch LogService 插件

镜像概述

该镜像为Ambassador API网关提供LogService插件功能，专门用于将Ambassador产生的日志数据转发至Elasticsearch索引，实现日志的集中化存储与管理。

核心功能和特性

• 与Ambassador无缝集成，作为LogService组件运行
• 实时收集Ambassador的访问日志、系统日志及错误日志
• 支持日志数据格式化处理，适配Elasticsearch索引结构
• 提供灵活的Elasticsearch连接配置选项
• 轻量级设计，对Ambassador性能影响小

使用场景和适用范围

• 需要将Ambassador网关日志集中存储到Elasticsearch的环境
• 基于Elasticsearch+Kibana栈进行日志分析与可视化的场景
• 微服务架构中需统一日志收集与检索的部署环境
• 对API访问日志有长期存储和分析需求的企业级应用

使用方法和配置说明

前提条件

• 已部署Ambassador API网关（版本v1.8+）
• 已部署可访问的Elasticsearch集群（版本6.x+）
• 具备容器编排环境（Kubernetes或Docker Compose）

环境变量配置

部署示例

Docker Run 命令

bash
docker run -d \
  --name ambassador-elasticsearch-logger \
  -e ELASTICSEARCH_URL=http://elasticsearch-host \
  -e ELASTICSEARCH_INDEX=ambassador-access-logs \
  -e ELASTICSEARCH_USER=elastic \
  -e ELASTICSEARCH_PASSWORD=changeme \
  -p 8080:8080 \
  your-registry/ambassador-logservice-elasticsearch:latest

Kubernetes 部署 (与Ambassador集成)

1. 创建Deployment:

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: ambassador-elasticsearch-logger
spec:
  replicas: 1
  selector:
    matchLabels:
      app: logservice
  template:
    metadata:
      labels:
        app: logservice
    spec:
      containers:
      - name: logservice
        image: your-registry/ambassador-logservice-elasticsearch:latest
        env:
        - name: ELASTICSEARCH_URL
          value: "http://elasticsearch:9200"
        - name: ELASTICSEARCH_INDEX
          value: "ambassador-logs"

2. 创建Service:

yaml
apiVersion: v1
kind: Service
metadata:
  name: ambassador-logservice
spec:
  selector:
    app: logservice
  ports:
  - port: 80
    targetPort: 8080

3. 配置Ambassador LogService:

yaml
apiVersion: getambassador.io/v3alpha1
kind: LogService
metadata:
  name: elasticsearch-logger
spec:
  service: ambassador-logservice:80
  driver: http
  config:
    url: "http://ambassador-logservice/log"

验证与测试

部署完成后，可通过以下方式验证日志是否正确发送至Elasticsearch：

1. 检查插件容器日志：docker logs ambassador-elasticsearch-logger
2. 在Elasticsearch中查询索引：curl -X GET "http://elasticsearch:9200/ambassador-logs/_search"
3. 通过Kibana查看日志数据是否正常显示