lightruncom/lightrun-helm-chart

镜像概述和主要用途

Lightrun Docker镜像提供实时代码级可观测性解决方案，允许开发者在运行中的应用程序内动态注入日志、指标和快照，无需重启或重新部署应用。该镜像旨在帮助开发和运维团队快速诊断问题、监控应用性能，提升代码级别的可见性。

核心功能和特性

• 实时可观测性：支持在运行时动态添加观测点，无需中断应用服务
• 代码级洞察：直接在代码层面获取关键信息，包括变量值、函数执行路径等
• 多语言支持：兼容主流编程语言（如Java、Python、Node.js等）
• 低侵入性：对应用性能影响极小，无需修改应用代码或配置
• 集成便捷：可与现有监控工具和日志系统无缝集成

使用场景和适用范围

• 开发调试：在开发环境中实时诊断代码问题，加速调试流程
• 生产监控：在生产环境中安全地添加临时观测点，排查线上问题
• 性能分析：监控关键代码路径的执行性能，识别瓶颈
• 持续集成/持续部署(CI/CD)：在自动化部署流程中集成实时可观测性验证

使用方法和配置说明

前提条件

• 已安装Docker引擎
• 拥有Lightrun账户和API密钥（可从Lightrun官方网站获取）

Docker部署示例

基本运行命令

bash
docker run -d \
  --name lightrun-agent \
  -e LIGHTRUN_API_KEY=<your-api-key> \
  -e APPLICATION_NAME=<your-app-name> \
  -v /path/to/your/app:/app \
  lightrun/agent:latest

关键环境变量说明

• LIGHTRUN_API_KEY：必填，Lightrun账户的API密钥，用于身份验证
• APPLICATION_NAME：必填，应用程序名称，用于在Lightrun控制台标识应用
• LIGHTRUN_ENVIRONMENT：可选，指定环境（如dev、staging、prod），默认为"default"
• LOG_LEVEL：可选，日志级别（DEBUG、INFO、WARN、ERROR），默认为"INFO"

集成到现有应用

如需将Lightrun代理集成到现有应用容器中，可通过以下方式修改Dockerfile：

dockerfile
FROM your-app-image:latest

# 安装Lightrun代理
RUN curl -fsSL [***] | sh

# 设置环境变量
ENV LIGHTRUN_API_KEY=<your-api-key>
ENV APPLICATION_NAME=<your-app-name>

# 启动应用时加载Lightrun代理
CMD ["lightrun-agent", "start", "--", "your-app-start-command"]