日志接入流程

日志统一接入流程

说明：服务云支持如下两种日志接入方式：

云端SaaS产品

  • 如云助手等，该类产品可以直接将组织好的接口数据通过服务云的接口发送到服务云，其云端清理工作由各应用自己完成。

接入步骤

流程

graph LR
A(1.身份认证)-->B(2.产品注册)
B-->C(3.日志接入)

详细说明：接口地址（全文档）

  1. 身份认证V2.0
  2. 产品注册
  3. 日志接入

非SaaS产品(私有部署产品)

  • 如ERP、MIP等，该类产品如需接入服务云，只需要按照服务云提供的接入标准将信息记录到本地即可，随后，运维AgentX将按照之前约定的方式进行采集，同时，其清理工作也会进行(若未按照标准将不负责清理)，同时，==建议各应用自身也附带清理策略，保证日志的增长不会影响到服务器其他应用以及自身的运行==。

接入步骤

流程

graph LR
A(1.应用在本地生成.dat文件)-->B(2.按照要求记录接口数据)
B-->C(3.清理数据)

流程说明

  1. 应用在本地生成 ==.dat== 文件（该文件为采集相关的配置信息，方便随后AgentX的采集工作）
  2. 生成的 ==.dat== 文件存储在系统的临时目录 C:/windows/temp/myun5468269/==xxxx.dat==，文件名为应用的安装目录转小写的md5值，md5(InstallPath.ToLower())，具体参考代码（C#）地址；
  3. 生成的具体内容也可以参考(C#) 地址-同2
  4. 关于结构可以参考如下，对应参数的取值和含义见导图链接
         {
       "StartTime": "2019-04-26T11:43:18.8552782+08:00", //启动时间
       "Application": {
         "AppName": "ERPV2.0",                           //产品对应的名称
         "Version": "V2.0",                              //产品版本
         "InstallPath": "D:\\Mysoft\\MysoftERP60\\",     //产品安装的位置
         "Url": "http://10.5.106.127:9050/",             //产品对应的URL地址(如果有)
         "Environment": "PROD"                           //产品的环境信息，
       },
       "Callback": {
         "AliveUrl": "/runtime/myun?action=alive",
         "LicenseUrl": "/runtime/myun?action=license",
         "UserUrl": "/runtime/myun?action=user"
       },
       "Databases": [
         {
           "DbType": "SQLSERVER",
           //下面的链接字符串是经过加密的，加密算法请见git@code.fdcyun.com:fishli/Nebula.Monitor.git 中的Encryptor类
           "EncConnectionString": "je9wxT30Cfy+gV17zwl8ucv9CV7eYD6rb7oVKMy6l6G/EDo0Y7sTlEH/c38VE81uzHKn2muwDNAj8tfisWxWvoYM/kPeY4ogyYmG6MqQ7gFDqkeS+kfTHyQASIRSzacaFRpylehlaSKAGbw5pPJ5PtShmI0prVXqnikDVc3Pu62kg/AyC2wLChss4wB9I0FcjnTDg6H/DLYG0ambBnMs/BooXSOqryE5U9dlUsefsgl86Rf/AQrEcA9M4OtsBEKLKbpdSa3UanhxXYbAW1SBD7ZRKZiTa73XSKbKWGtQNWcmCuP/don2ee8sIO/UZte2zu50pUxDwmVWSvoy3HrvCw==.jYMPJuyJaH3x4fubMNUXt5SyFcnrfLvps2O2Rm9V6kY4cNCfMrfH2DPuLMb6C7P372TMm0pC26eooeYsUDze1MIu6LoUMwpPqXQq5lAeyw/VlW+SpgTdugzXrAPHyAehdEzTTabZbYzyEJY9gwt3jaewJnHQNmjdPOa/D9wHN6OY2CQtrBCmE4B2bRT09Zs4IjvLyy1nicB9xgElJ1J/kg=="
         }
       ],
       "PushOption": {
         "DbType": "SQLSERVER",
          //下面的链接字符串是经过加密的，加密算法请见git@code.fdcyun.com:fishli/Nebula.Monitor.git 中的Encryptor类
         "EncConnectionString": "HpjKDoV2/AXBM0Eoa971JcAWVF4xLzu/fJWv76/cyP4Xr3/sCzb/f1bLqGEFTvm0knRDiIBOLTqlpbtCwsJWtDzOX6n/MO3cdQ2jpPEGItNBmNDwZn9vViV7sy8K5p2Q6KvPl0uv6keOvI9BVk9+/aQTtVzUQ+I9Avahdjlh/89DHYEPrqNwnFSFGImVzgzrR9Yk6vIbm8cW2tlgxIUdOyqJ52Rz4e1uZIS+bx3wDuTWBwiwTtPgSn4jkttneTU88ffY66giAR1HjuoFEGP6+hgOWZJv8uznEq+cofySEBEq3F5JjbEDi0IiV/fvR3+O1/hWV2aYUZxwmg/NOS87ZA==.rweLahXleZrq2lV6hotlR1lvueSzVN8gPXzUHlZnjNmomxwNPnPo9FzRJjSOocBuRfztCwjdZbvIqMs/q511SRgIKuZrajbzUxjUnrZWStFdHK5oEH/knRYgfLMnQ48tR7PRphVEkcsDCu2e+XAMmsmYoHKILGI/Ajzdc89eVqE1+O9VhkW3b3DVjFJQyOTkI22zra7dcuTJvtsoaD/60A==",
         //存储位置
         "PerformanceData": "Myun_PerformanceData",
         "ExceptionData": "Myun_ExceptionData",
         "UserActionData": "Myun_UserActionData"
       }
     }
  5. 数据库链接加密验证 地址（安全考虑，不提供私有部署及代码）
  6. 关于接入的数据，支持3种（性能数据、异常数据、用户操作数据），参考结构
  7. ==重要说明== 采集工具只会采集配置中安装路径存在且环境信息设置是PROD的配置。环境枚举
  8. 日志存储请参考 写入日志

开发辅助及建议

  • 强烈建议在理解后，再次阅读此思维导图
  • ==建议接入应用在重启后或数据库连接修改后，重新生成.dat，保证数据为最新==
  • 日志数据生成、写入相关代码参考(此仓库仅供参考,部分采集信息需要接入方自行填充)
    git@code.fdcyun.com:fishli/Nebula.Monitor.git