Xray 是一个基于 Elasticsearch 的全文检索工具，广泛应用于日志分析和可视化。以下是使用 Xray 的基本指南

安装 Xray

从官方下载

• 访问 Xray 官方网站。
• 下载对应平台的安装包。

使用 Docker

• 拉取 Docker 镜像：

  docker pull xray/xray

• 启动 Xray:

  docker run -d -p 10900:10900 xray/xray

手动安装

• 提取压缩包并执行安装脚本：

  ./xray-x.y.z-linux-x86_64.rpm

配置 Xray

启用 Xray

• 启动服务并访问 Xray 界面：

  xray start

• 访问 http://localhost:10900 进入 Xray。

配置 Elasticsearch

• 修改 config/xray.yml：

  index:
    name: your_index_name

• 启用 Xray 插件：

  xray enable plugin

使用 Xray 进行日志管理

导入日志数据

• 使用 Elasticsearch -ingest 命令：

  curl -X POST -H "Content-Type: application/json" -d '{"source": "your/log/path"}' http://localhost:920/xray-logs/_doc

• 使用 Xray 日志摄取插件：

  xray-log-cutter your_log_file.log

数据预处理

• 执行预处理脚本：

  ./xray-preprocess.py input.log

Xray 查询与可视化

构建查询

• 使用 Xray 查询语法：

  {
    "term": {
      "query": "log.level == 'INFO' AND source_type == 'web'
    }
  }

• 运行查询并查看结果。

可视化

• 使用 Kibana 插件：

  xray visualize "your_query" my_visualization

安全设置

设置访问控制

• 修改 config/xray.yml：

  http:
    authentication: basic
    realm: simple
    users:
      - name: admin
        password: admin

IP 白名单

• 修改配置文件限制访问：

  http:
    server:
      listen: 0...
      port: 10900
    access_control_list: ["192.168.*.*", "10.*.*.*"]

性能优化

• 分批处理数据：

  xray search "your_query" --from 0 --size 100

• 使用滚动索引：

  xray create rollup index

• 调整索引存储：

  index:
    storage:
      type: mmap

集成与扩展

与 ELK 集成

• 将 Xray 结合 Elasticsearch 和 Kibana，形成 ELK 集群。

云平台集成

• 在 AWS、Azure 等云平台上部署 Elasticsearch 和 Xray,进行云原生日志管理。

扩展能力

• 使用自定义插件扩展 Xray 功能。
• 集成第三方分析工具,提升数据处理能力。

常见问题与故障排除

• 数据导入问题：
  • 检查输入数据格式是否正确。
  • 确认 Elasticsearch 索引是否存在。
• 连接错误：
  • 检查 Elasticsearch 服务是否运行。
  • 确认网络连接是否正常。
• 查询错误：
  • 验证查询语法是否正确。
  • 检查索引字段是否匹配。

通过以上步骤，您可以有效地使用 Xray 进行日志分析和可视化,提升工作效率和数据处理能力。