Simple Log Service:Utiliser AliyunLogConfig pour gérer une configuration Logtail

Créer une configuration Logtail

Créez une CR à partir de AliyunLogConfig. Après la création de la CR, alibaba-log-controller génère une configuration Logtail basée sur la CR et l'applique automatiquement.

1. Obtenir le fichier kubeconfig d'un cluster et utiliser kubectl pour se connecter au cluster.

2. Exécutez la commande suivante pour créer un fichier YAML. Dans cet exemple, le nom du fichier est cube.yaml. Adaptez le nom du fichier selon vos besoins.

   vim cube.yaml

3. Saisissez le script suivant dans le fichier YAML et configurez les paramètres selon vos besoins. Le script contient uniquement les champs requis. Définissez inputType pour spécifier la méthode de collecte des journaux, et configurez inputDetail pour définir les paramètres d'entrée des journaux. Pour plus d'informations sur les champs de la CR, consultez la rubrique Paramètres de la CR.

   apiVersion: log.alibabacloud.com/v1alpha1      # Use the default value. You do not need to modify this parameter.
   kind: AliyunLogConfig                          # Use the default value. You do not need to modify this parameter.
   metadata:
     name: test-config                            # The name of the resource. The name must be unique in the current Kubernetes cluster.
   spec:
     logstore: k8s-stdout                         # The name of the Logstore. If the Logstore that you specify does not exist, Simple Log Service automatically creates the Logstore.
     logtailConfig:                               # The Logtail configuration.
       inputType: plugin                          # The type of the data source from which logs are collected.
       configName: test-config                    # The name of the Logtail configuration.
       inputDetail:                               # The details of the Logtail configuration.
         ...

4. Exécutez la commande suivante pour créer la CR à partir de AliyunLogConfig. Une fois la configuration Logtail effective, Logtail commence à collecter les données et à les envoyer à Simple Log Service.

   kubectl apply -f cube.yaml

5. Vérifiez que la valeur du champ statusCode de la CR est 200. Pour obtenir des instructions, consultez la section Consulter les configurations Logtail.

Consulter les configurations Logtail

Pour afficher toutes les configurations Logtail créées par AliyunLogConfig dans le cluster Kubernetes actuel, exécutez la commande suivante :

kubectl get aliyunlogconfigs

Pour afficher les détails et l'état d'une seule configuration Logtail créée par AliyunLogConfig, exécutez la commande suivante. Remplacez <config_name> par le nom de la ressource AliyunLogConfig. Adaptez le nom selon vos besoins.

kubectl get aliyunlogconfigs <config_name> -o yaml

Un résultat similaire à celui ci-dessous est renvoyé. Dans cet exemple, la configuration Logtail utilise inputType: file.

apiVersion: log.alibabacloud.com/v1alpha1
kind: AliyunLogConfig
metadata:
  name: example-k8s-file
  namespace: kube-system
spec:
  project: k8s-log-test
  logstore: k8s-file
  logtailConfig:
    inputType: file
    configName: example-k8s-file
    inputDetail:
      logType: common_reg_log
      logPath: /data/logs/app_1
      filePattern: test.LOG
      dockerFile: true
status:
  status: OK
  statusCode: 200

Les champs status et statusCode du résultat indiquent l'état de la configuration Logtail :

• Si la valeur du champ statusCode est 200, la configuration Logtail est appliquée.

• Si la valeur du champ statusCode n'est pas 200, l'application de la configuration Logtail a échoué. Vérifiez le champ status pour connaître l'état signalé.

Mettre à jour une configuration Logtail

Pour mettre à jour une configuration Logtail créée par AliyunLogConfig, modifiez le fichier YAML existant de la CR et appliquez-le à nouveau.

1. Obtenir le fichier kubeconfig d'un cluster et utiliser kubectl pour se connecter au cluster.

2. Modifiez le fichier YAML AliyunLogConfig existant, tel que cube.yaml.

   vim cube.yaml

3. Modifiez les paramètres dans le fichier YAML selon vos besoins. Pour plus d'informations sur les champs de la CR, consultez la rubrique Paramètres de la CR.

4. Exécutez la commande suivante pour appliquer le fichier et rendre la configuration Logtail effective.

   kubectl apply -f cube.yaml

5. Vérifiez que la valeur du champ statusCode de la CR est 200. Pour obtenir des instructions, consultez la section Consulter les configurations Logtail.

Supprimer une configuration Logtail

Pour supprimer une configuration Logtail créée par AliyunLogConfig, supprimez la CR correspondante. Dans la commande suivante, remplacez <config_name> par le nom de la ressource AliyunLogConfig. Adaptez le nom selon vos besoins.

kubectl delete aliyunlogconfigs <config_name>

Pour confirmer la suppression, exécutez kubectl get aliyunlogconfigs et vérifiez que la CR n'apparaît plus dans la liste.

apiVersion

La valeur est fixée à log.alibabacloud.com/v1alpha1.

kind

La valeur est fixée à AliyunLogConfig.

metadata

Le champ metadata identifie la CR dans le cluster Kubernetes.

spec

Le champ spec spécifie le projet et le LogStore de destination, les attributs du LogStore de destination ainsi que les détails de la configuration Logtail.

AliyunLogConfigDetail

Pour plus d'informations sur les paramètres, consultez la rubrique Configurations Logtail (héritées). Le format de données de AliyunLogConfigDetail est identique au format décrit dans la rubrique Configurations Logtail (héritées).