🚀
快速开始
5 分钟完成服务部署,立即开启日志收集之旅
🔧
客户端集成
支持 C#、Java、JavaScript 等多种语言 SDK 接入
📊
数据仪表盘
实时监控、错误分析、性能洞察一站式管理
🔒
安全最佳实践
API Key 鉴权、数据加密、访问控制指南

🚀 快速开始

系统要求

  • PHP 8.0 或更高版本
  • MySQL 5.7 或更高版本
  • Nginx 或 Apache Web 服务器
  • HTTPS 证书(生产环境推荐)

部署步骤

1. 下载源码到服务器
   git clone https://github.com/aethergate/log-server.git

2. 配置 Web 服务器伪静态规则
   # Nginx 示例
   location / {
       try_files $uri $uri/ /index.php?$query_string;
   }

3. 创建数据库并导入结构
   mysql -u root -p
   CREATE DATABASE aethergate_log CHARACTER SET utf8mb4;

4. 访问安装页面
   https://your-domain.com/install

5. 按照向导完成安装

验证安装

安装完成后,访问首页会显示「实时运行中」状态,登录控制台即可查看数据。

🔧 客户端集成

初始化 SDK

// C# 示例
using AetherGate.Features.Update;

// 应用启动时配置
LogUploadClient.DefaultBaseAddress = new Uri("https://your-domain.com");
LogUploadClient.ApiKey = "your-api-key-here";
LogUploadClient.AppName = "MyApplication";
LogUploadClient.AppVersion = "1.0.0";

上报日志事件

var logClient = AppConfig.GetService<LogUploadClient>();

// 上报功能调用
logClient?.TrackFeature("UserLogin", new { 
    login_method = "cookie",
    user_id = 12345
});

// 上报异常
try
{
    await DoSomethingAsync();
}
catch (Exception ex)
{
    logClient?.TrackError(ex, "DoSomething", new { context = "production" });
}

事件分类说明

分类 说明 使用场景
Runtime 运行时心跳 应用启动、保活、会话
Feature 功能调用 用户操作、业务流程
Error 异常错误 捕获异常、崩溃信息
Performance 性能指标 接口耗时、资源占用

📊 数据仪表盘

可用仪表盘

📈
数据仪表盘
在线设备、日志量、启动数实时统计
🔴
错误分析
异常排行榜、最近错误预览
📊
功能统计
功能调用排行、用户活跃度
⚡
性能监控
操作耗时分布、性能瓶颈识别
💻
设备管理
接入设备列表、版本分布
⚙️
系统设置
API Key 管理、数据清理

🔒 安全最佳实践

API Key 管理

  • 不要将 API Key 硬编码在客户端代码中
  • 使用环境变量或配置文件管理 API Key
  • 定期轮换 API Key,建议 90 天更换一次
  • 生产环境禁用调试 API Key

数据安全

  • 传输层使用 HTTPS 加密
  • 不要在上报数据中包含敏感信息(密码、密钥等)
  • 合理设置日志保留期限,定期清理历史数据
  • 数据库定期备份
查看 API 文档 → 获取技术支持