更新时间:2024-11-06 GMT+08:00

配置集群日志

功能介绍

用户可以选择集群管理节点上哪些组件的日志上报LTS

调用方法

请参见如何调用API

URI

PUT /api/v3/projects/{project_id}/cluster/{cluster_id}/log-configs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,获取方式请参见如何获取接口URI中参数

约束限制:

不涉及

取值范围:

账号的项目ID

默认取值:

不涉及

cluster_id

String

参数解释:

集群ID,获取方式请参见如何获取接口URI中参数

约束限制:

不涉及

取值范围:

集群ID

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

参数解释:

消息体的类型(格式)

约束限制:

GET方法不做校验

取值范围:

  • application/json

  • application/json;charset=utf-8

  • application/x-pem-file

默认取值:

不涉及

X-Auth-Token

String

参数解释:

调用接口的认证方式分为Token和AK/SK两种,如果您使用的Token方式,此参数为必填,请填写Token的值,获取方式请参见获取token

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

ttl_in_days

Integer

存储时长

log_configs

Array of log_configs objects

日志配置项

表4 log_configs

参数

是否必选

参数类型

描述

name

String

日志类型

enable

Boolean

是否采集

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

ttl_in_days

Integer

存储时长

log_configs

Array of log_configs objects

日志配置项

表6 log_configs

参数

参数类型

描述

name

String

日志类型

enable

Boolean

是否采集

请求示例

配置集群日志上报LTS

/api/v3/projects/{project_id}/cluster/{cluster_id}/log-configs

{
  "log_configs" : [ {
    "name" : "kube-apiserver",
    "enable" : true
  }, {
    "name" : "kube-controller-manager",
    "enable" : false
  }, {
    "name" : "kube-scheduler",
    "enable" : false
  }, {
    "name" : "volcano",
    "enable" : true
  }, {
    "name" : "coredns",
    "enable" : false
  }, {
    "name" : "everest",
    "enable" : false
  } ]
}

响应示例

状态码: 200

表示集群日志配置成功

{
  "ttl_in_days" : 7,
  "log_configs" : [ {
    "name" : "kube-controller-manager",
    "enable" : true
  }, {
    "name" : "kube-apiserver",
    "enable" : true
  }, {
    "name" : "kube-scheduler",
    "enable" : true
  }, {
    "name" : "audit",
    "enable" : true
  } ]
}

SDK代码示例

SDK代码示例如下。

配置集群日志上报LTS

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
package com.huaweicloud.sdk.test;

import com.huaweicloud.sdk.core.auth.ICredential;
import com.huaweicloud.sdk.core.auth.BasicCredentials;
import com.huaweicloud.sdk.core.exception.ConnectionException;
import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
import com.huaweicloud.sdk.core.exception.ServiceResponseException;
import com.huaweicloud.sdk.cce.v3.region.CceRegion;
import com.huaweicloud.sdk.cce.v3.*;
import com.huaweicloud.sdk.cce.v3.model.*;

import java.util.List;
import java.util.ArrayList;

public class UpdateClusterLogConfigSolution {

    public static void main(String[] args) {
        // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
        // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
        String ak = System.getenv("CLOUD_SDK_AK");
        String sk = System.getenv("CLOUD_SDK_SK");
        String projectId = "{project_id}";

        ICredential auth = new BasicCredentials()
                .withProjectId(projectId)
                .withAk(ak)
                .withSk(sk);

        CceClient client = CceClient.newBuilder()
                .withCredential(auth)
                .withRegion(CceRegion.valueOf("<YOUR REGION>"))
                .build();
        UpdateClusterLogConfigRequest request = new UpdateClusterLogConfigRequest();
        request.withClusterId("{cluster_id}");
        ClusterLogConfig body = new ClusterLogConfig();
        List<ClusterLogConfigLogConfigs> listbodyLogConfigs = new ArrayList<>();
        listbodyLogConfigs.add(
            new ClusterLogConfigLogConfigs()
                .withName("kube-apiserver")
                .withEnable(true)
        );
        listbodyLogConfigs.add(
            new ClusterLogConfigLogConfigs()
                .withName("kube-controller-manager")
                .withEnable(false)
        );
        listbodyLogConfigs.add(
            new ClusterLogConfigLogConfigs()
                .withName("kube-scheduler")
                .withEnable(false)
        );
        listbodyLogConfigs.add(
            new ClusterLogConfigLogConfigs()
                .withName("volcano")
                .withEnable(true)
        );
        listbodyLogConfigs.add(
            new ClusterLogConfigLogConfigs()
                .withName("coredns")
                .withEnable(false)
        );
        listbodyLogConfigs.add(
            new ClusterLogConfigLogConfigs()
                .withName("everest")
                .withEnable(false)
        );
        body.withLogConfigs(listbodyLogConfigs);
        request.withBody(body);
        try {
            UpdateClusterLogConfigResponse response = client.updateClusterLogConfig(request);
            System.out.println(response.toString());
        } catch (ConnectionException e) {
            e.printStackTrace();
        } catch (RequestTimeoutException e) {
            e.printStackTrace();
        } catch (ServiceResponseException e) {
            e.printStackTrace();
            System.out.println(e.getHttpStatusCode());
            System.out.println(e.getRequestId());
            System.out.println(e.getErrorCode());
            System.out.println(e.getErrorMsg());
        }
    }
}

配置集群日志上报LTS

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
# coding: utf-8

import os
from huaweicloudsdkcore.auth.credentials import BasicCredentials
from huaweicloudsdkcce.v3.region.cce_region import CceRegion
from huaweicloudsdkcore.exceptions import exceptions
from huaweicloudsdkcce.v3 import *

if __name__ == "__main__":
    # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak = os.environ["CLOUD_SDK_AK"]
    sk = os.environ["CLOUD_SDK_SK"]
    projectId = "{project_id}"

    credentials = BasicCredentials(ak, sk, projectId)

    client = CceClient.new_builder() \
        .with_credentials(credentials) \
        .with_region(CceRegion.value_of("<YOUR REGION>")) \
        .build()

    try:
        request = UpdateClusterLogConfigRequest()
        request.cluster_id = "{cluster_id}"
        listLogConfigsbody = [
            ClusterLogConfigLogConfigs(
                name="kube-apiserver",
                enable=True
            ),
            ClusterLogConfigLogConfigs(
                name="kube-controller-manager",
                enable=False
            ),
            ClusterLogConfigLogConfigs(
                name="kube-scheduler",
                enable=False
            ),
            ClusterLogConfigLogConfigs(
                name="volcano",
                enable=True
            ),
            ClusterLogConfigLogConfigs(
                name="coredns",
                enable=False
            ),
            ClusterLogConfigLogConfigs(
                name="everest",
                enable=False
            )
        ]
        request.body = ClusterLogConfig(
            log_configs=listLogConfigsbody
        )
        response = client.update_cluster_log_config(request)
        print(response)
    except exceptions.ClientRequestException as e:
        print(e.status_code)
        print(e.request_id)
        print(e.error_code)
        print(e.error_msg)

配置集群日志上报LTS

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
package main

import (
	"fmt"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
    cce "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3"
	"github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/model"
    region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/cce/v3/region"
)

func main() {
    // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
    // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
    ak := os.Getenv("CLOUD_SDK_AK")
    sk := os.Getenv("CLOUD_SDK_SK")
    projectId := "{project_id}"

    auth := basic.NewCredentialsBuilder().
        WithAk(ak).
        WithSk(sk).
        WithProjectId(projectId).
        Build()

    client := cce.NewCceClient(
        cce.CceClientBuilder().
            WithRegion(region.ValueOf("<YOUR REGION>")).
            WithCredential(auth).
            Build())

    request := &model.UpdateClusterLogConfigRequest{}
	request.ClusterId = "{cluster_id}"
	nameLogConfigs:= "kube-apiserver"
	enableLogConfigs:= true
	nameLogConfigs1:= "kube-controller-manager"
	enableLogConfigs1:= false
	nameLogConfigs2:= "kube-scheduler"
	enableLogConfigs2:= false
	nameLogConfigs3:= "volcano"
	enableLogConfigs3:= true
	nameLogConfigs4:= "coredns"
	enableLogConfigs4:= false
	nameLogConfigs5:= "everest"
	enableLogConfigs5:= false
	var listLogConfigsbody = []model.ClusterLogConfigLogConfigs{
        {
            Name: &nameLogConfigs,
            Enable: &enableLogConfigs,
        },
        {
            Name: &nameLogConfigs1,
            Enable: &enableLogConfigs1,
        },
        {
            Name: &nameLogConfigs2,
            Enable: &enableLogConfigs2,
        },
        {
            Name: &nameLogConfigs3,
            Enable: &enableLogConfigs3,
        },
        {
            Name: &nameLogConfigs4,
            Enable: &enableLogConfigs4,
        },
        {
            Name: &nameLogConfigs5,
            Enable: &enableLogConfigs5,
        },
    }
	request.Body = &model.ClusterLogConfig{
		LogConfigs: &listLogConfigsbody,
	}
	response, err := client.UpdateClusterLogConfig(request)
	if err == nil {
        fmt.Printf("%+v\n", response)
    } else {
        fmt.Println(err)
    }
}

更多编程语言的SDK代码示例,请参见API Explorer的代码示例页签,可生成自动对应的SDK代码示例。

状态码

状态码

描述

200

表示集群日志配置成功

错误码

请参见错误码