自建K8s（kubernetes）是开源的一个容器编排引擎，它支持自动化部署、大规模可伸缩、应用容器化管理。用户将自建K8s集群内服务或集群节点特定路径文件的应用日志上报至LTS后，可以对Kubernetes集群内服务日志进行存储和分析。

您可以按照如下步骤完成接入配置。

1. 选择日志流：选择将日志存储到对应的日志流中，便于不同类型日志分类存储管理。

2. 检查依赖项：自动检查依赖项是否符合要求。

3. 安装日志采集组件：在主机上安装ICAgent。

4. 选择主机组（可选）：选择日志接入的主机范围，主机组是为了便于分类管理、提升配置多个主机日志采集的效率，对主机进行虚拟分组的单位。可以将需要采集日志的一台或多台主机加入到同一个主机组中，再将该主机组关联至同一个接入配置中。

5. 采集配置：配置日志的采集路径、采集策略等。

6. 结构化配置：通过不同的日志提取方式将日志流中的日志进行结构化。

7. 索引配置：索引是一种存储结构，用于对日志数据进行查询。通过配置索引后，可对日志进行查询和分析操作。

8. 完成接入配置：接入成功后，可以在接入列表进行任务的增删改查。

若需要采集多个场景的日志，您可以选择批量设置多个接入配置的方式，同时设置多个接入配置。

前提条件

• 请确保已在Kubernetes集群中执行安装Helm v3的命令。

• 请确保Kubernetes集群已配置kubectl。

• 已创建日志组和日志流。

步骤1：选择日志流

1. 登录管理控制台，选择“管理与部署 > 云日志服务 LTS”，进入“日志管理”页面。

2. 在左侧导航栏中，选择“日志接入 > 接入中心”，单击“自建k8s - 应用日志”进行自建K8s接入配置。或在左侧导航栏中，选择“日志接入 > 接入管理”，单击“创建”，在弹出的页面中，单击“自建k8s - 应用日志”进行自建K8s接入配置。

3. 采集方式：采集到集中日志流和采集到自定义日志流，您可以根据实际情况选择采集方式。

   1. 若选择“采集到集中日志流”，请执行如下操作步骤：

      1. 集中采集日志到一个固定的日志流。Kubernetes集群默认的采集日志流分别为标准输出/错误stdout-{ClusterID}、节点文件hostfile-{ClusterID}、容器文件containerfile-{ClusterID}、K8S事件: event-{ClusterID}。日志流名称会根据ClusterID自动命名，例如：集群ID为Cluster01，则标准输出/错误日志流为stdout-Cluster01。

      2. 在一个kubernetes集群下可以创建的采集日志流为标准输出/错误stdout-{ClusterID}、节点文件hostfile-{ClusterID}、容器文件containerfile-{ClusterID}）和K8s事件event-{ClusterID}，如果某个日志组下，已创建某种采集日志流，则不会在其他日志组或当前日志组下再创建该日志流。

         1. 选择采集方式“采集到集中日志流”。

         2. 输入“集群名称”和“集群ID”。

         3. 选择“所属日志组”。当无该日志组时，系统会提示：暂无该日志组，后续操作中，系统将会为您自动创建，创建完成后日志会集中采集到该日志组中。

   2. 若选择“采集到自定义日志流”，请执行如下操作步骤：

      1. 选择采集方式“采集到自定义日志流”。

      2. 输入“集群名称”和“集群ID”。

      3. 单击“所属日志组”后的目标框，在下拉列表中选择具体的日志组，若没有所需的日志组，单击“所属日志组”目标框后的“新建”，在弹出的创建日志组页面创建新的日志组。

      4. 单击“所属日志流”后的目标框，在下拉列表中选择具体的日志流，若没有所需的日志流，单击“所属日志流”目标框后的“新建”，在弹出的创建日志流页面创建新的日志流。

4. 单击“下一步：检查依赖项”。

步骤2：检查依赖项

1. 系统自动检查以下三项是否符合要求：

   1. 存在自定义标识符为k8s-log-集群ID的主机组。

   2. 存在名为k8s-log-集群ID的日志组。支持修改日志组的日志存储时间和备注。当选择日志流为采集到集中日志流时，会进行该项内容检查。

   3. 存在系统推荐的集中采集的日志流。支持修改日志流的日志存储时间和备注。当选择日志流为采集到集中日志流时，会进行该项内容检查。

      如果以上三项中，有任意一项不符合要求，需单击“自动修复”按钮进行修复，否则将无法进行下一步操作。

      自动修复：一键帮您完成以上三项配置。

      重新检查：重新检查依赖项。

2. 单击“下一步：安装日志采集组件”。

步骤3：安装日志采集组件

在Kubernetes集群中，选择任意一台主机，按照LTS页面的提示执行如下操作步骤：

1. 在LTS的安装日志采集组件页面，获取ICAgent安装包。

2. 在LTS页面上复制解压命令，解压ICAgent安装包。

3. 执行如下命令，进入icagentK8s目录。

   cd icagentK8s

4. 在生成安装命令下方，选择接入日志的区域名、接入日志的账号的项目ID。

5. k8s集群所在区域选择“区域内”。

   1. 在安装步骤下方，复制ICAgent安装命令。执行的命令需要填写AK/SK，有两种方式可选择：复制命令时手动替换AK/SK或者直接执行命令时再根据提示替换AK/SK。

   2. 使用PuTTY等远程登录工具，以root用户登录待安装主机，执行复制到的ICAgent安装命令。

      当显示“ICAgent install success”时，表示安装成功，安装成功后，在主机列表下方查看ICAgent状态显示“运行”。

      安装ICAgent成功后，单击“确认安装完毕”。

步骤4：选择主机组（可选）

1. 在主机组列表中，默认选择集群所在的主机组，您可以根据需要选择其他已创建的主机组。

2. 单击“下一步：采集配置”。

步骤5：采集配置

采集配置项涉及日志的采集范围、采集方式、格式处理等内容配置，请参考以下步骤完成采集配置。

1. 采集配置名称：自定义采集配置名称，长度范围为1到64个字符，只支持输入英文、数字、中文、中划线、下划线以及小数点，且不能以小数点、下划线开头或以小数点结尾。

2. 数据源配置：选择数据源类型，进行对应的数据源配置。

3. 当数据源类型选择容器标准输出和容器文件路径时，设置K8s匹配规则，非必选项。填写正则匹配规则后，单击校验按钮，支持校验确保正则表达式的正确性。

4. 其他配置。设置采集路径后，您还可以设置日志拆分、采集二进制文件、自定义元数据等。

5. 参考下表配置日志格式、日志时间。

步骤6：结构化配置

1. 结构化配置（可选项）。

   说明

   当所选日志流已配置结构化时，请谨慎执行删除操作。

2. 单击“下一步：索引配置”。

步骤7：索引配置

索引是一种存储结构，用于对日志数据进行查询。通过配置索引后，可对日志进行查询和分析操作。不同的索引配置，则会产生不同的查询和分析结果，请根据您的需要，合理配置索引。

• 若您暂时无需通过某字段进行查询或分析，接入时可以直接跳过索引配置，不影响日志采集。待日志接入成功后，再根据业务需求优化索引配置（仅对新写入的日志生效）。在“索引配置”页面保持默认设置，直接单击“跳过并提交”，界面提示“日志接入成功”。

• 若您需要通过特定字段进行查询或分析，接入时请在“索引配置”页面配置索引。

  您可以单击“自动配置”，云日志服务LTS会根据近15分钟的第一条日志内容或常见内置保留字段（例如hostIP、hostName、pathFile）自动生成字段索引。或者手动添加字段，只能添加已结构化的字段。设置完成后，单击“提交”，界面提示“日志接入成功”。日志接入成功后，您仍可以根据业务需求随时调整索引配置（仅对新写入的日志生效）。

步骤8：完成接入配置

接入成功后会生成一条接入配置信息。

• 单击接入配置名称可进入详情页面，查看该接入配置详细信息。

• 单击接入配置操作列的“修改”重新修改接入配置信息。

• 单击接入配置操作列的“更多 > 标签管理”即可添加标签。

• 单击接入配置操作列的“更多 > 复制”复制一条新的接入配置信息。

• 单击接入配置操作列的“删除”即可删除接入配置信息。

• 若不需要采集日志，关闭“接入配置开关”列的开关。若需要重新采集日志，需要重新开启“接入配置开关”列的开关。

批量设置多个接入配置

支持同时批量设置多个接入配置，操作简单，不用重复配置即可快速完成多个场景的接入配置。

1. 在“接入管理”页面，单击“批量创建”，进入配置详情页面。

   1. 接入类型：选择自建k8s - 应用日志。

   2. 规则列表：

      1. 在输入框填写接入配置数量，单击“添加接入配置”。

      2. 在右侧配置项下方自定义填写“规则名称”，配置项设置完成后，也可以双击左侧接入配置的名称自定义命名。规则名称只支持输入英文、数字、中文、中划线、下划线及小数点，且不能以小数点、下划线开头或以小数点结尾。长度为1-64个字符。

      3. 鼠标放在接入配置上面，单击即可直接复制接入配置。

      4. 鼠标放在接入配置上面，单击，在弹出的提示框单击“确定”删除接入配置。

   3. 配置项：

      1. 左侧显示接入配置的信息，最多支持添加99个配置。

      2. 右侧显示配置接入的内容，详细请参考步骤5：采集配置进行设置。

      3. 一个接入配置设置完成后，单击“应用于其他接入配置”即可将该接入配置复制到其他接入配置。

2. 单击“参数检查”，检查成功后，单击“提交”，批量接入设置完成。例如添加了4个接入配置，批量创建成功后，在“接入管理”下方，就会显示4条接入配置任务。

3. （可选）支持对接入配置任务进行以下操作：

   1. 勾选多个已创建成功的接入配置，单击“批量编辑”进入配置详情页面，通过选择不同接入类型，修改对应的接入配置信息。

   2. 勾选多个接入配置开关显示关闭的接入配置，单击“接入配置开启/关闭”，选择“开启”即可批量开启接入配置任务。

   3. 勾选多个接入配置开关显示开启的接入配置，单击“接入配置开启/关闭”，选择“关闭”。接入配置状态关闭后不会继续采集日志，请谨慎操作。

   4. 勾选多个已创建成功的接入配置，单击删除按钮即可批量删除接入配置。