newrelic/fastly-to-insights

Fastly to Insights Docker镜像文档

镜像概述和主要用途

Fastly to Insights Docker镜像是New Relic官方推荐的解决方案，用于将Fastly服务的指标数据导入至New Relic Insights平台。该镜像以Docker容器形式封装，简化了Fastly与New Relic Insights的集成流程，帮助用户快速实现指标数据的采集、传输与分析。

主要用途：将Fastly服务的实时监控指标（如请求量、响应时间、错误率等）导入至New Relic Insights，实现指标数据的集中化存储、分析与可视化。

核心功能和特性

• 跨平台集成：通过Fastly Real-Time Analytics API采集指标数据，并通过New Relic Insights API完成数据导入，实现两者无缝对接。
• 环境变量配置：支持通过环境变量灵活配置关键参数，无需修改代码即可适配不同部署环境。
• 多服务支持：可同时监控多个Fastly服务，通过指定服务ID列表（空格分隔）实现批量数据采集。
• 容器化部署：以Docker容器形式提供，支持各类容器化环境（如Docker Engine、Kubernetes等），部署流程简单高效。

使用场景和适用范围

适用对象

• 使用Fastly CDN服务的企业或技术团队。
• 需要在New Relic Insights中分析Fastly服务性能指标的运维人员、DevOps团队或数据分析师。

典型使用场景

• Fastly服务性能监控：将Fastly实时指标导入Insights，构建统一监控看板，实时追踪服务健康状态。
• 指标集中分析：在Insights中整合Fastly数据与其他业务系统数据，进行关联分析和趋势预测。
• 自动化数据采集：替代手动导出/导入流程，通过容器化服务实现指标数据的定时、自动化采集与上传。

使用方法和配置说明

前置条件

使用本镜像前，需准备以下必要信息和权限：

• 有效的New Relic账户（已启用Insights功能）。
• 有效的Fastly账户（具有Read访问权限）。
• New Relic Insights Insert密钥（用于授权数据导入）。
• Fastly API密钥（用于访问Fastly指标数据）。

环境变量配置

本镜像通过环境变量进行配置，以下为必填参数：

注意：SERVICES需使用空格分隔的服务ID字符串。因Fastly API限制需逐个查询服务，且Docker无法通过命令行传递数组参数，故采用此格式。

使用示例

Docker Run命令示例

通过以下命令启动容器，替换占位符为实际配置值：

shell
$ docker run \
  -e ACCOUNT_ID='你的New Relic账户ID' \
  -e FASTLY_KEY='你的Fastly API密钥' \
  -e INSERT_KEY='你的New Relic Insights Insert密钥' \
  -e SERVICES='服务ID1 服务ID2 服务ID3' \  # 以空格分隔多个Fastly服务ID
  newrelic/fastly-to-insights

补充信息

贡献指南

欢迎提交Pull Request参与项目改进。提交即表示您授予New Relic非独占、不可撤销、免费的许可，允许其在产品中使用代码、算法、专利及相关技术思路。代码按"原样"提供，不附带任何适用性或正确性担保。

参考链接

• Fastly Real-Time Analytics API文档：[***]
• New Relic Insights API文档：https://docs.newrelic.com/docs/insights/insights-data-sources/custom-data/insert-custom-events-insights-api

免责声明

本项目按"原样"提供，不附带任何形式的担保或技术支持，但您可通过项目仓库报告问题或参与贡献。