Managing ICAgent in Container Scenarios
ICAgent is a log collection tool for LTS. It runs on hosts where logs need to be collected. This section describes how to install ICAgent on a host, upgrade ICAgent, uninstall ICAgent, and check the ICAgent status.
Container scenarios cover services deployed on Kubernetes container platforms .
Installing ICAgent
- Installing ICAgent in a CCE cluster
Currently, ICAgent can be installed only in CCE standard and Turbo clusters. You cannot install ICAgent in CCE Autopilot or Agile clusters.
- Choose Host Management > Hosts in the navigation pane.
- Click the CCE Cluster tab. Select ICAgent Status in the search box to filter clusters whose ICAgent is in Uninstalled state, select one of the clusters, and click Upgrade ICAgent.
- When a CCE cluster is created, ICAgent is installed on its hosts by default and reports logs to LTS. The Output to AOM feature is disabled by default. If you enabled Output to AOM after cluster creation but want to switch back to reporting logs to LTS, ensure Output to AOM is disabled before upgrading ICAgent. For Ingesting CCE Application Logs to LTS, you are advised to collect container standard output to LTS instead of AOM.
If Output to AOM is enabled, LTS will charge you based on the actual log traffic. For details, see LTS Pricing Details.
- CCE cluster ID: Each cluster has a fixed ID.
- When ICAgent is upgraded, LTS automatically creates a log group and host group for your CCE cluster, named k8s-log-{Cluster ID}. You can ingest logs of this CCE cluster to this log group when creating an ingestion configuration. For details, see Ingesting CCE Application Logs to LTS.
- If the cluster's hosts do not have ICAgent installed or have an outdated version, clicking Upgrade ICAgent will install or upgrade ICAgent on all hosts in the cluster.
- When a CCE cluster is created, ICAgent is installed on its hosts by default and reports logs to LTS. The Output to AOM feature is disabled by default. If you enabled Output to AOM after cluster creation but want to switch back to reporting logs to LTS, ensure Output to AOM is disabled before upgrading ICAgent. For Ingesting CCE Application Logs to LTS, you are advised to collect container standard output to LTS instead of AOM.
- In the displayed dialog box, click OK.
The ICAgent upgrade takes about 1 minute. When the ICAgent status changes from Updating to Running, the upgrade is successful.
Upgrading ICAgent
Upgrading ICAgent in a CCE cluster is the same as the installation process. For details, see Installing ICAgent in a CCE cluster.
- Upgrading ICAgent does not affect your services. You are advised to upgrade ICAgent during off-peak hours.
- During the upgrade, the monitoring metrics reported by ICAgent are interrupted for about 2 to 3 minutes.
- Upgrading ICAgent does not affect log collection. After the upgrade, ICAgent will continue collecting logs from the position before the upgrade.
Checking the ICAgent Status
To check the ICAgent status of a target host, choose Host Management > Hosts in the navigation pane, and click the CCE Cluster tab. For status details, see Table 1.
Status |
Description |
---|---|
Running |
ICAgent is running properly. |
Uninstalled |
ICAgent is not installed. |
Installing |
ICAgent is being installed. This process takes about 1 minute. |
Installation failed |
ICAgent installation failed. |
Upgrading |
ICAgent is being upgraded. This process takes about 1 minute. |
Upgrade failed |
ICAgent upgrade failed. |
Offline |
ICAgent is abnormal because the AK/SK is incorrect. Obtain the correct AK/SK and install ICAgent again. |
Faulty |
ICAgent is faulty. Contact technical support. |
Uninstalling |
ICAgent is being uninstalled. This process takes about 1 minute. |
Authentication error |
Authentication fails because parameters were incorrectly configured during ICAgent installation. |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.