开发者社区 问答 正文

logtail 如何配置的?


logtail 配置叫做 config,每个 project 默认可以创建 100 个配置(config)。Config 名称在 project 下具备唯一性。
您可以通过 config 指定日志收集的位置、方式和参数。
[backcolor=transparent]config 命名规范:

  • 只能包括小写字母,数字,短横线(-)和下划线(_)
  • 必须以小写字母或者数字开头和结尾
  • 长度必须在 2~128 字节以内

完整资源示例:

属性名称类型是否必须描述
configNamestring日志配置名称, project 下唯一
inputTypestring输入类型,默认为 file
inputDetailjson见下表格说明
outputTypestring输出类型,目前只支持 LogService
outputDetailstring见下表格说明
createTime(output-only)integer配置创建时间
lastModifyTime(output-only)integer该资源服务端更新时间

inputDetail 内容:
属性名称类型必须描述
logTypestring日志类型,现在只支持 common_reg_log
logPathstring日志所在的父目录,例如/var/logs/
filePatternstring日志文件的 Pattern,例如access*.log
localStorageboolean是否打开本地缓存,在服务端之间链路断开的情况下,本地可以缓存 1GB 日志
timeFormatstring日志时间格式, 如%Y/%m/%d %H:%M:%S
logBeginRegexstring日志首行特征(正则表达式),由于匹配多行日志组成一条 log 的情况
regexstring日志对提取正则表达式
keyarray日志提取后所生成的 Key
filterKeyarray用于过滤日志所用到的 key,只有 key 的值满足对应 filterRegex 列中设定的正则表达式日志才是符合要求的
filterRegexarray和每个 filterKey 对应的正正则表达式, filterRegex 的长度和 filterKey 的长度必须相同
topicFormatstring用于将日志文件路径的某部分作为 topic,如/var/log/(.*).log,默认为 none,表示 topic 为空
preservebooleantrue 代表监控目录永不超时,false 代表监控目录 30 分钟超时,默认值为 true
preserveDepthinteger当设置 preserve 为 false 时,指定监控不超时目录的深度,最大深度支持 3

outputDetail 内容:
属性名称类型必须描述
[tr=rgb(239, 251, 255)][td]logstoreName string是对应 logstore 名称

展开
收起
轩墨 2017-10-23 16:29:53 1827 分享 版权
阿里云 AI 助理回答

您提到的是阿里云日志服务(Log Service)中的Logtail配置详情。Logtail是阿里云日志服务的数据采集代理,负责从各种数据源收集日志并发送到Log Service中存储和分析。下面是对您提供信息的总结和补充说明:

Logtail配置(Config)概述

  • 命名规范:每个Config名称必须在所属Project内唯一,且遵循命名规则:小写字母、数字、短横线(-)和下划线(_)组成,长度限制在2到128字节之间,以小写字母或数字开头和结尾。
  • 数量限制:默认情况下,每个Project可以创建最多100个不同的Config。

Config结构概览

输入类型(InputType)

  • 默认值file
  • 输入细节(InputDetail)
    • logType:日志类型,当前仅支持common_reg_log
    • logPath:日志文件的父目录路径。
    • filePattern:匹配日志文件名的模式。
    • 其他参数:如本地缓存设置、时间格式、日志首行特征正则表达式、日志内容提取正则表达式、提取后的Key、过滤条件等,用于精确控制日志的识别与处理方式。

输出类型(OutputType)

  • 目前支持LogService
  • 输出细节(OutputDetail)
    • logstoreName:必填,指定日志将被发送到的Logstore名称。

高级配置项

  • topicFormat:允许根据日志文件路径动态生成topic。
  • preservepreserveDepth:控制监控目录的超时行为,适用于需要长期监控特定目录而不因无活动而停止的情况。

实践建议

  • 在设计Config时,确保正则表达式准确无误,避免因错误的正则导致日志无法正确采集或解析。
  • 考虑日志量和频率,合理配置本地缓存大小和监控目录的超时策略,以优化资源使用和保证数据完整性。
  • 使用topicFormat功能可以灵活地对日志进行分类,便于后续的日志管理和分析。

通过上述配置,您可以高效、精准地从不同来源收集日志,并利用阿里云Log Service的强大能力进行实时分析、监控和报警,为您的应用运维、业务分析提供有力支持。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答