Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion VERSION
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.3.45
0.3.46
120 changes: 100 additions & 20 deletions src/UK8S/Models/ULSExtractRule.php
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ class ULSExtractRule extends Response


/**
* CollectPolicy: 采集策略。可选值: full (全量采集存量日志), increment (从当前时间点增量采集)。默认为 full。
* CollectPolicy: 采集策略。可选值full全量采集存量日志)、increment从当前时间点增量采集。默认为 full。
*
* @return string|null
*/
Expand All @@ -33,7 +33,7 @@ public function getCollectPolicy()
}

/**
* CollectPolicy: 采集策略。可选值: full (全量采集存量日志), increment (从当前时间点增量采集)。默认为 full。
* CollectPolicy: 采集策略。可选值full全量采集存量日志)、increment从当前时间点增量采集。默认为 full。
*
* @param string $collectPolicy
*/
Expand All @@ -43,7 +43,7 @@ public function setCollectPolicy($collectPolicy)
}

/**
* Encode: 日志原文的编码格式。可选值: utf-8, gbk。默认为 utf-8。
* Encode: 日志原文的编码格式。可选值utf-8gbk。默认为 utf-8。
*
* @return string|null
*/
Expand All @@ -53,7 +53,7 @@ public function getEncode()
}

/**
* Encode: 日志原文的编码格式。可选值: utf-8, gbk。默认为 utf-8。
* Encode: 日志原文的编码格式。可选值utf-8gbk。默认为 utf-8。
*
* @param string $encode
*/
Expand All @@ -63,7 +63,7 @@ public function setEncode($encode)
}

/**
* LogType: 日志解析类型,决定了如何结构化日志
* LogType: 日志解析类型。可选值:json、delimiter、full_regex、multi_line_full_regex、multi_line_delimiter、minimal_list、multi_line
*
* @return string|null
*/
Expand All @@ -73,7 +73,7 @@ public function getLogType()
}

/**
* LogType: 日志解析类型,决定了如何结构化日志
* LogType: 日志解析类型。可选值:json、delimiter、full_regex、multi_line_full_regex、multi_line_delimiter、minimal_list、multi_line
*
* @param string $logType
*/
Expand All @@ -83,7 +83,7 @@ public function setLogType($logType)
}

/**
* Delimiter: 当 LogType 为delimiter_log 时可选,可选字段 ' ',' ','|',';',','
* Delimiter: 分隔符。适用于 delimiter 或 multi_line_delimiter,可选值:space、tab、|、;、,。
*
* @return string|null
*/
Expand All @@ -93,7 +93,7 @@ public function getDelimiter()
}

/**
* Delimiter: 当 LogType 为delimiter_log 时可选,可选字段 ' ',' ','|',';',','
* Delimiter: 分隔符。适用于 delimiter 或 multi_line_delimiter,可选值:space、tab、|、;、,。
*
* @param string $delimiter
*/
Expand All @@ -103,7 +103,27 @@ public function setDelimiter($delimiter)
}

/**
* BeginningRegex: 行首正则表达式。当 logType 为多行模式 (如 multiline_log 或 multiline_fullregex_log) 时,用于标识一条新日志的开始。
* DelimiterBase64: Base64 编码的分隔符。填写时优先于 Delimiter。
*
* @return string|null
*/
public function getDelimiterBase64()
{
return $this->get("DelimiterBase64");
}

/**
* DelimiterBase64: Base64 编码的分隔符。填写时优先于 Delimiter。
*
* @param string $delimiterBase64
*/
public function setDelimiterBase64($delimiterBase64)
{
$this->set("DelimiterBase64", $delimiterBase64);
}

/**
* BeginningRegex: 行首正则表达式。在 multi_line、multi_line_full_regex 或 multi_line_delimiter 模式下,BeginningRegex 和 BeginningRegexBase64 必须至少填写一个。
*
* @return string|null
*/
Expand All @@ -113,7 +133,7 @@ public function getBeginningRegex()
}

/**
* BeginningRegex: 行首正则表达式。当 logType 为多行模式 (如 multiline_log 或 multiline_fullregex_log) 时,用于标识一条新日志的开始
* BeginningRegex: 行首正则表达式。在 multi_line、multi_line_full_regex 或 multi_line_delimiter 模式下,BeginningRegex 和 BeginningRegexBase64 必须至少填写一个
*
* @param string $beginningRegex
*/
Expand All @@ -123,7 +143,27 @@ public function setBeginningRegex($beginningRegex)
}

/**
* LogRegex: 日志提取正则表达式。当 logType 为正则模式 (如 fullregex_log 或 multiline_fullregex_log) 时,用于从日志中提取字段。
* BeginningRegexBase64: Base64 编码的行首正则表达式。填写时优先于 BeginningRegex。
*
* @return string|null
*/
public function getBeginningRegexBase64()
{
return $this->get("BeginningRegexBase64");
}

/**
* BeginningRegexBase64: Base64 编码的行首正则表达式。填写时优先于 BeginningRegex。
*
* @param string $beginningRegexBase64
*/
public function setBeginningRegexBase64($beginningRegexBase64)
{
$this->set("BeginningRegexBase64", $beginningRegexBase64);
}

/**
* LogRegex: 日志提取正则表达式。在 full_regex 或 multi_line_full_regex 模式下,LogRegex 和 LogRegexBase64 必须至少填写一个。
*
* @return string|null
*/
Expand All @@ -133,7 +173,7 @@ public function getLogRegex()
}

/**
* LogRegex: 日志提取正则表达式。当 logType 为正则模式 (如 fullregex_log 或 multiline_fullregex_log) 时,用于从日志中提取字段
* LogRegex: 日志提取正则表达式。在 full_regex 或 multi_line_full_regex 模式下,LogRegex 和 LogRegexBase64 必须至少填写一个
*
* @param string $logRegex
*/
Expand All @@ -143,7 +183,27 @@ public function setLogRegex($logRegex)
}

/**
* TimeKey: 指定时间字段。
* LogRegexBase64: Base64 编码的日志提取正则表达式。填写时优先于 LogRegex。
*
* @return string|null
*/
public function getLogRegexBase64()
{
return $this->get("LogRegexBase64");
}

/**
* LogRegexBase64: Base64 编码的日志提取正则表达式。填写时优先于 LogRegex。
*
* @param string $logRegexBase64
*/
public function setLogRegexBase64($logRegexBase64)
{
$this->set("LogRegexBase64", $logRegexBase64);
}

/**
* TimeKey: 包含日志时间的字段名。
*
* @return string|null
*/
Expand All @@ -153,7 +213,7 @@ public function getTimeKey()
}

/**
* TimeKey: 指定时间字段
* TimeKey: 包含日志时间的字段名
*
* @param string $timeKey
*/
Expand All @@ -163,7 +223,7 @@ public function setTimeKey($timeKey)
}

/**
* TimeFormat: timeKey 对应的时间格式。如: %Y-%m-%d %H:%M:%S
* TimeFormat: TimeKey 对应的时间格式。在 json、full_regex 或 multi_line_full_regex 模式下,填写 TimeKey 时必须同时填写 TimeFormat。
*
* @return string|null
*/
Expand All @@ -173,7 +233,7 @@ public function getTimeFormat()
}

/**
* TimeFormat: timeKey 对应的时间格式。如: %Y-%m-%d %H:%M:%S
* TimeFormat: TimeKey 对应的时间格式。在 json、full_regex 或 multi_line_full_regex 模式下,填写 TimeKey 时必须同时填写 TimeFormat。
*
* @param string $timeFormat
*/
Expand All @@ -183,7 +243,7 @@ public function setTimeFormat($timeFormat)
}

/**
* UnMatchUpload: 是否上传解析失败的日志。true 表示上传,false 表示丢弃。默认为 false。
* UnMatchUpload: 是否上传解析失败的日志。字符串 true 表示上传,false 表示丢弃。默认为 false。
*
* @return string|null
*/
Expand All @@ -193,7 +253,7 @@ public function getUnMatchUpload()
}

/**
* UnMatchUpload: 是否上传解析失败的日志。true 表示上传,false 表示丢弃。默认为 false。
* UnMatchUpload: 是否上传解析失败的日志。字符串 true 表示上传,false 表示丢弃。默认为 false。
*
* @param string $unMatchUpload
*/
Expand All @@ -203,7 +263,7 @@ public function setUnMatchUpload($unMatchUpload)
}

/**
* UnMatchKey: 如果 unMatchUpload 为 true,无法解析的日志原文将被存放在此字段指定的 Key 下。默认为 LogParseFailure
* UnMatchKey: 存放无法解析的日志原文的 Key。UnMatchUpload 为 true 时必须填写
*
* @return string|null
*/
Expand All @@ -213,12 +273,32 @@ public function getUnMatchKey()
}

/**
* UnMatchKey: 如果 unMatchUpload 为 true,无法解析的日志原文将被存放在此字段指定的 Key 下。默认为 LogParseFailure
* UnMatchKey: 存放无法解析的日志原文的 Key。UnMatchUpload 为 true 时必须填写
*
* @param string $unMatchKey
*/
public function setUnMatchKey($unMatchKey)
{
$this->set("UnMatchKey", $unMatchKey);
}

/**
* Keys: 提取后的字段名列表。仅适用于 delimiter、full_regex、multi_line_full_regex 和 multi_line_delimiter。
*
* @return string[]|null
*/
public function getKeys()
{
return $this->get("Keys");
}

/**
* Keys: 提取后的字段名列表。仅适用于 delimiter、full_regex、multi_line_full_regex 和 multi_line_delimiter。
*
* @param string[] $keys
*/
public function setKeys(array $keys)
{
$this->set("Keys", $keys);
}
}
32 changes: 26 additions & 6 deletions src/UK8S/Models/ULSInputDetail.php
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ class ULSInputDetail extends Response


/**
* FilePaths: 采集路径,数组
* FilePaths: 日志采集路径列表。仅适用于 container_file
*
* @return ULSFilePaths[]|null
*/
Expand All @@ -41,7 +41,7 @@ public function getFilePaths()
}

/**
* FilePaths: 采集路径,数组
* FilePaths: 日志采集路径列表。仅适用于 container_file
*
* @param ULSFilePaths[] $filePaths
*/
Expand All @@ -55,7 +55,7 @@ public function setFilePaths(array $filePaths)
}

/**
* Type: 日志输入类型。当前主要支持 container_file,表示采集容器标准输出或文件
* Type: 日志输入类型。可选值:container_file、container_stdout
*
* @return string|null
*/
Expand All @@ -65,7 +65,7 @@ public function getType()
}

/**
* Type: 日志输入类型。当前主要支持 container_file,表示采集容器标准输出或文件
* Type: 日志输入类型。可选值:container_file、container_stdout
*
* @param string $type
*/
Expand All @@ -75,7 +75,27 @@ public function setType($type)
}

/**
* InputMetadata: 定义哪些容器相关的元数据需要附加到日志中。
* Stream: 容器标准输出流类型。仅适用于 container_stdout,可选值:all、stdout、stderr,默认为 all。
*
* @return string|null
*/
public function getStream()
{
return $this->get("Stream");
}

/**
* Stream: 容器标准输出流类型。仅适用于 container_stdout,可选值:all、stdout、stderr,默认为 all。
*
* @param string $stream
*/
public function setStream($stream)
{
$this->set("Stream", $stream);
}

/**
* InputMetadata: 定义需要附加到日志中的容器相关元数据。
*
* @return ULSInputMetadata|null
*/
Expand All @@ -85,7 +105,7 @@ public function getInputMetadata()
}

/**
* InputMetadata: 定义哪些容器相关的元数据需要附加到日志中
* InputMetadata: 定义需要附加到日志中的容器相关元数据
*
* @param ULSInputMetadata $inputMetadata
*/
Expand Down
31 changes: 18 additions & 13 deletions src/UK8S/UK8SClient.php
Original file line number Diff line number Diff line change
Expand Up @@ -1267,26 +1267,31 @@ public function listUK8SNodeGroup(ListUK8SNodeGroupRequest $request = null)
* "ClusterId" => (string) uk8s集群id
* "MachineGroup" => (string) 机器组
* "ExtractRule" => (object) 定义日志的提取、解析和格式化规则。见 ULSExtractRule[
* "CollectPolicy" => (string) 采集策略。可选值: full (全量采集存量日志), increment (从当前时间点增量采集)。默认为 full。
* "Encode" => (string) 日志原文的编码格式。可选值: utf-8, gbk。默认为 utf-8。
* "LogType" => (string) 日志解析类型,决定了如何结构化日志。
* "Delimiter" => (string) 当 LogType 为delimiter_log 时可选,可选字段 ' ',' ','|',';',','
* "BeginningRegex" => (string) 行首正则表达式。当 logType 为多行模式 (如 multiline_log 或 multiline_fullregex_log) 时,用于标识一条新日志的开始。
* "LogRegex" => (string) 日志提取正则表达式。当 logType 为正则模式 (如 fullregex_log 或 multiline_fullregex_log) 时,用于从日志中提取字段。
* "TimeKey" => (string) 指定时间字段。
* "TimeFormat" => (string) timeKey 对应的时间格式。如: %Y-%m-%d %H:%M:%S
* "UnMatchUpload" => (string) 是否上传解析失败的日志。true 表示上传,false 表示丢弃。默认为 false。
* "UnMatchKey" => (string) 如果 unMatchUpload 为 true,无法解析的日志原文将被存放在此字段指定的 Key 下。默认为 LogParseFailure。
* "CollectPolicy" => (string) 采集策略。可选值:full(全量采集存量日志)、increment(从当前时间点增量采集)。默认为 full。
* "Encode" => (string) 日志原文的编码格式。可选值:utf-8、gbk。默认为 utf-8。
* "LogType" => (string) 日志解析类型。可选值:json、delimiter、full_regex、multi_line_full_regex、multi_line_delimiter、minimal_list、multi_line。
* "Delimiter" => (string) 分隔符。适用于 delimiter 或 multi_line_delimiter,可选值:space、tab、|、;、,。
* "DelimiterBase64" => (string) Base64 编码的分隔符。填写时优先于 Delimiter。
* "BeginningRegex" => (string) 行首正则表达式。在 multi_line、multi_line_full_regex 或 multi_line_delimiter 模式下,BeginningRegex 和 BeginningRegexBase64 必须至少填写一个。
* "BeginningRegexBase64" => (string) Base64 编码的行首正则表达式。填写时优先于 BeginningRegex。
* "LogRegex" => (string) 日志提取正则表达式。在 full_regex 或 multi_line_full_regex 模式下,LogRegex 和 LogRegexBase64 必须至少填写一个。
* "LogRegexBase64" => (string) Base64 编码的日志提取正则表达式。填写时优先于 LogRegex。
* "TimeKey" => (string) 包含日志时间的字段名。
* "TimeFormat" => (string) TimeKey 对应的时间格式。在 json、full_regex 或 multi_line_full_regex 模式下,填写 TimeKey 时必须同时填写 TimeFormat。
* "UnMatchUpload" => (string) 是否上传解析失败的日志。字符串 true 表示上传,false 表示丢弃。默认为 false。
* "UnMatchKey" => (string) 存放无法解析的日志原文的 Key。UnMatchUpload 为 true 时必须填写。
* "Keys" => (array<string>) 提取后的字段名列表。仅适用于 delimiter、full_regex、multi_line_full_regex 和 multi_line_delimiter。
* ]
* "InputDetail" => (object) 定义日志的输入来源(例如容器文件)。见 ULSInputDetail[
* "FilePaths" => (array<object>) 采集路径,数组。[
* "FilePaths" => (array<object>) 日志采集路径列表。仅适用于 container_file。[
* [
* "Path" => (string) 定义采集路径
* "File" => (string) 采集文件
* ]
* ]
* "Type" => (string) 日志输入类型。当前主要支持 container_file,表示采集容器标准输出或文件。
* "InputMetadata" => (object) 定义哪些容器相关的元数据需要附加到日志中。[
* "Type" => (string) 日志输入类型。可选值:container_file、container_stdout。
* "Stream" => (string) 容器标准输出流类型。仅适用于 container_stdout,可选值:all、stdout、stderr,默认为 all。
* "InputMetadata" => (object) 定义需要附加到日志中的容器相关元数据。[
* "Container" => (string) 指定具体要采集元数据的容器名。如果留空,则不采集容器的元数据,可选字段:container_name,namespace,pod_name,pod_ip,pod_uid,container_id,image_name。Pod Label 元数据通过指定 InputDetail.Metadata.Labels 字段。
* "Labels" => (string) 定义要采集哪些 Pod 的标签 (Labels)。可选值:*:采集所有标签。app,version:仅采集 app 和 version 这两个标签。""(空字符串):不采集任何标签。
* ]
Expand Down
Loading