Objectifs

Dans ce tutoriel, vous allez :

• Configurez IBM Cloud Logs Routing pour qu'il achemine les journaux de la plate-forme vers une instance IBM Cloud Logs dans une région.

• Vérifiez que les journaux de la plate-forme sont acheminés vers votre instance IBM Cloud Logs.

Avant de commencer

Procédez comme suit :

1. Passez en revue A propos de IBM® Cloud Logs Routing pour comprendre les concepts.

2. Installez tous les outils prérequis comme décrit dans le démarrage.

3. Pour obtenir des détails sur un locataire en utilisant l'API, vérifiez que vous pouvez vous connecter à IBM Cloud Logs Routing en utilisant l'API de gestion. Pour plus d'informations, voir Connexion à IBM® Cloud Logs Routing.

4. Les journaux de la plate-forme qui sont acheminés vers IBM Cloud Logs comprennent des champs de métadonnées que vous pouvez utiliser pour gérer les données et configurer les fonctionnalités de votre instance IBM Cloud Logs.

   Le nom de l'application est l'environnement qui produit et envoie les journaux à IBM Cloud Logs. Les journaux de la plate-forme ont le nom de l'application défini comme ibm-platform-log.

   Le nom du sous-système est le service ou l'application qui produit et envoie des journaux ou des mesures à IBM Cloud Logs. Les journaux de la plate-forme ont le nom du sous-système défini comme CRNserviceName:instanceID. Pour les journaux de la plate-forme VPC, le champ est défini sur is:resourceType.

5. Définir les autorisations pour gérer les cibles dans le compte. Pour plus d'informations, voir Octroi de droits IAM.

   Avant de pouvoir configurer le service IBM Cloud Logs Routing pour acheminer les journaux de votre plateforme, vous avez besoin d'un IBM Cloud® Identity and Access Management (jeton d'accès IAM) pour l'authentification. La CLI IBM Cloud est utilisée pour obtenir ces informations.

   1. Connectez-vous à votre compte IBM Cloud. Inclure l'option --sso si vous utilisez un identifiant fédéré.

      ibmcloud login [--sso]
      

      Le résultat comprendra votre nom d'utilisateur, comme dans l'exemple suivant :

      Targeted account Jane Doe\'s Account (111111111112a21af53a2aeed19a1542a44) <-> 11111156
      
      
       API endpoint:     https://cloud.ibm.com
       Region:           us-south
       User:             Jane.Doe@ibm.com
       Account:          Jane Doe\'s Account (111111111112a21af53a2aeed19a1542a44) <-> 11111156
       Resource group:   No resource group targeted, use 'ibmcloud target -g RESOURCE_GROUP'
      

   2. Pour accorder l'accès à l'utilisation de IBM Cloud Logs Routing à votre utilisateur, collectez le nom d'utilisateur à partir de la sortie générée ci-dessus. Dans notre exemple, ce serait Jane.Doe@ibm.com. Remplacez <username> par votre nom d'utilisateur dans la commande suivante :

      ibmcloud iam user-policy-create <username> --roles Manager --service-name logs-router
      

      Au lieu d'attribuer des rôles directement aux identités, une stratégie courante consiste à attribuer des rôles aux groupes d'accès et à ajouter des identités en tant que membres de ces groupes d'accès. Pour plus d'informations sur les groupes d'accès, voir Configuration de groupes d'accès.

Création d'une autorisation de service à service

Vous devez utiliser IBM Cloud® Identity and Access Management (IAM) pour créer une autorisation qui accorde IBM Cloud Logs Routing l'accès à IBM Cloud Logs.

Récupération de vos IBM Cloud Logs informations

Pour acheminer des données vers une instance IBM Cloud Logs, vous avez besoin d'informations sur la destination des journaux. Vous avez besoin des informations suivantes pour votre instance IBM Cloud Logs:

• L'instance CRN
• Le point d'arrivée et le port d'ingestion (ingress)

Utilisez cette commande pour récupérer l' URL e et l'ID :

ibmcloud resource service-instances --service-name logs --long --output JSON | jq '[.[] | {name: .name, id: .id, region: .region_id, ingestion_endpoint: .extensions.external_ingress}]'

Si vous disposez de plusieurs instances, choisissez celle que vous souhaitez utiliser pour recevoir les journaux de la plate-forme et enregistrez les informations pour plus tard.

Le point final est similaire à :

ingestion_endpoint: 3a622101-7521-4002-bf91-8c26e17eedcf.ingress.eu-de.logs.cloud.ibm.com

L'ID est similaire à :

"crn:v1:bluemix:public:logs:eu-es:a/15ff25632a21af53a2aeed19a1542a44:3a622101-7521-4002-bf91-8c26e17eedcf::"

Pour obtenir toutes les informations sur l'instance, vous pouvez exécuter ibmcloud resource service-instances --service-name logs --long --output JSON Cette commande répertorie toutes vos instances IBM Cloud Logs. Vous avez besoin des champs suivants : ID qui contient le CRN de l'instance, extensions.external_ingress qui contient le point d'entrée, et extensions.virtual_private_endpoints.endpoints.ports.port_max qui contient la valeur du port.

Création d'un locataire et d'une cible

Pour recevoir les journaux de votre plateforme, vous devez créer un locataire avec le service IBM Cloud Logs Routing.

Vous devez créer votre locataire dans la région où vous souhaitez collecter et acheminer les journaux de plate-forme vers l'instance IBM Cloud Logs.

curl -X POST https://<MANAGEMENT-API-ENDPOINT>:443/v1/tenants \
-H "Content-Type: application/json" \
-H "Authorization: ${IAM_TOKEN}" \
-H 'IBM-API-Version: DATE' \
--data '{
    "name": "TENANT_NAME",
    "targets": [
        {
            "log_sink_crn": "CLOUD_LOGS_INSTANCE_ID",
            "name": "TARGET_NAME",
            "parameters": {
                "host": "CLOUD_LOGS_INSTANCE_INGRESS_ENDPOINT",
                "port": PORT
            }
        }
    ]
}'

{
    "id": "3517d2ed-9429-af34-ad52-34278391cbc8:",
    "created_at": "2023-10-20T18:30:00.143156Z",
    "updated_at": "2023-10-20T18:30:00.143156Z",
    "crn": "crn:v1:bluemix:public:logs-router:eu-de:a/3516b8fa0a174a71899f5affa4f18d78:3517d2ed-9429-af34-ad52-34278391cbc8::",
    "name": "tenant",
    "etag": "\"822b4b5423e225206c1d75666595714a11925cd0f82b229839864443d6c3c049\"",
    "targets": [
    {
        "id": "86432b-66a6-df12-7003-888a21a2b3",
        "log_sink_crn": "crn:v1:bluemix:public:logs:eu-gb:a/91d1d1e42f9b684df920bbd06461c222:743e3b4f-72bc-4669-9fa6-0e6621d0b232::",
        "name": "my-log-sink",
        "etag": "\"c3a43545a7f2675970671ac3a57b8db067a1866b2222e1b950ee8da612e347c6\"",
        "type": "logs",
        "created_at": "2023-10-20T18:30:00.143156Z",
        "updated_at": "2023-10-20T18:30:00.143156Z",
        "parameters": {
            "host": "743e3b4f-72bc-4669-9fa6-0e6621d0b232.ingress.eu-gb.logs.cloud.ibm.com",
            "port": 443
        }
    }
    ]
}

Vérification de l'envoi des journaux à la cible de destination

Pour vous assurer que les journaux de votre plate-forme sont bien transmis à IBM Cloud Logs, procédez comme suit :

1. Lancer l'interface web IBM Cloud Logs pour l'instance IBM Cloud Logs qui est configurée en tant que cible pour collecter les journaux de plate-forme dans une région. Il s'agit de l'instance que vous avez sélectionnée dans l'étape de configuration d'une cible.

2. Visualiser les journaux à l'aide de vues personnalisées. Pour plus d'informations, voir Affichage des journaux.

Tous les journaux de la plateforme sont générés en JSON. Vous pouvez filtrer les journaux de plate-forme dans votre instance en sélectionnant la valeur de ibm-platform-logs comme applicationName.