Installation de l'agent hôte sur Amazon Elastic Container Service (ECS)

Modifier en ligne

Pour installer l'agent hôte dans un cluster Elastic Container Service (ECS) fonctionnant sur Elastic Computing ( EC2 ) à l'aide de la planification des démons ECS. Suivez les étapes indiquées pour utiliser soit les données utilisateur d' EC2, soit une définition de tâche ECS.

Pour Fargate sur AWS ECS, consultez la documentation relative à la surveillance de Fargate.

Déploiement de l'agent hôte à l'aide des données utilisateur d' EC2

Modifier en ligne
Remarque : ce mécanisme est la méthode recommandée pour déployer l'agent hôte sur vos clusters ECS sur EC2.

La documentation intitulée « Lancer une instance de conteneur Amazon ECS » explique comment utiliser les données utilisateur sur les nouvelles instances d' EC2 s qui alimentent vos clusters ECS sur EC2.

Les mécanismes décrits dans la documentation d' Instana relative à la surveillance des instances d' AWS EC2 s'appliquent également à ce cas d'utilisation.

Déploiement de l'agent hôte à l'aide d'une définition de tâche ECS

Modifier en ligne

Zones requises

Modifier en ligne

Les paramètres suivants sont nécessaires pour que les applications d' Java soient correctement surveillées par Instana :

{
    "ipcMode": "host",
    "pidMode": "host",
    "privileged": true,
    "networkMode": "host",
    ...
}

Exemple

Modifier en ligne

Vous pouvez modifier le fichier ` JSON ` pour l'adapter à vos besoins lors du déploiement de l'agent hôte.

Remarque: Les zones que vous devez modifier sont marquées comme <required>. Vous devez définir les zones <required> en tant que chaînes.

Exemple de fichier ` JSON ` :

{
    "ipcMode": "host",
    "executionRoleArn": null,
    "containerDefinitions": [
        {
            "dnsSearchDomains": null,
            "logConfiguration": {
                "logDriver": "json-file"
            },
            "entryPoint": null,
            "portMappings": [],
            "command": null,
            "linuxParameters": null,
            "environment": [
                {
                    "name": "INSTANA_AGENT_ENDPOINT",
                    "value": <required>
                },
                {
                    "name": "INSTANA_AGENT_ENDPOINT_PORT",
                    "value": <required>
                },
                {
                    "name": "INSTANA_AGENT_KEY",
                    "value": <required>
                }
            ],
            "ulimits": null,
            "dnsServers": null,
            "mountPoints": [
                {
                    "readOnly": false,
                    "containerPath": "/var/run",
                    "sourceVolume": "var_run"
                },
                {
                    "readOnly": false,
                    "containerPath": "/run",
                    "sourceVolume": "run"
                },
                {
                    "readOnly": false,
                    "containerPath": "/sys",
                    "sourceVolume": "sys"
                },
                {
                    "readOnly": false,
                    "containerPath": "/dev",
                    "sourceVolume": "dev"
                },
                {
                    "readOnly": false,
                    "containerPath": "/var/log",
                    "sourceVolume": "log"
                }
            ],
            "workingDirectory": null,
            "secrets": null,
            "dockerSecurityOptions": null,
            "memory": <required>,
            "volumesFrom": null,
            "image": <required: the image used to start your container. Up to 255 letters (uppercase and lowercase), numbers, hyphens, underscores, colons, periods, forward slashes, and number signs are allowed.>,
            "disableNetworking": null,
            "interactive": null,
            "healthCheck": null,
            "essential": true,
            "links": null,
            "hostname": null,
            "extraHosts": null,
            "pseudoTerminal": null,
            "user": null,
            "readonlyRootFilesystem": null,
            "dockerLabels": null,
            "systemControls": null,
            "privileged": true,
            "name": <required: the name of a container. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.>,
            "repositoryCredentials": {
                "credentialsParameter": ""
            }
        }
    ],
    "placementConstraints": [],
    "memory": <required>,
    "taskRoleArn": "",
    "family": <required: specify a name for your task definition. Up to 255 letters (uppercase and lowercase), numbers, hyphens, and underscores are allowed.>,
    "pidMode": "host",
    "requiresCompatibilities": [
        "EC2"
    ],
    "networkMode": "host",
    "cpu": "<Required>",
    "volumes": [
        {
            "name": "dev",
            "host": {
                "sourcePath": "/dev"
            },
            "dockerVolumeConfiguration": null
        },
        {
            "name": "sys",
            "host": {
                "sourcePath": "/sys"
            },
            "dockerVolumeConfiguration": null
        },
        {
            "name": "var_run",
            "host": {
                "sourcePath": "/var/run"
            },
            "dockerVolumeConfiguration": null
        },
        {
            "name": "run",
            "host": {
                "sourcePath": "/run"
            },
            "dockerVolumeConfiguration": null
        },
        {
            "name": "log",
            "host": {
                "sourcePath": "/var/log"
            },
            "dockerVolumeConfiguration": null
        }
    ]
}

Dépannage du déploiement des agents

Modifier en ligne

Si l'installation de l'agent échoue, vous pouvez consulter les messages du journal et les conseils de dépannage. Si cette section consacrée au dépannage ne permet pas de résoudre votre problème, veuillez contacter l'équipe d'assistance d' IBM Instana en lui fournissant des détails sur le problème rencontré. Ces informations nous aident à vous aider et à améliorer notre documentation.

Pour obtenir des informations générales sur le dépannage de tous les agents hôtes, consultez la section Dépannage.