Help Center > > FAQs> Guide of Upgrading the Telescope to the ICAgent

Guide of Upgrading the Telescope to the ICAgent

Updated at:Mar 17, 2020 GMT+08:00

Introduction

To improve your experience, HUAWEI CLOUD Log Tank Service (LTS) has upgraded its system architecture. After the upgrade, you need to use the new agent ICAgent to collect logs.

Upgrade impacts:

  • Existing users are affected. Existing users need to replace the Telescope agent with the ICAgent. That is, uninstall the Telescope agent, install the ICAgent and import the collected log data configured in the Telescope agent to the ICAgent.
  • For a new user, install the latest version of the ICAgent.

Upgrade time: Aug 17, 2019 07:00 - Aug 31 2019 23:59 GMT+08:00. During the upgrade, existing users need to upgrade the agent by following the instructions provided in this document.

Agent Upgrade Process

Step 1: Obtaining the AK/SK

Before installing the ICAgent, you need to obtain the Access Key ID/Secret Access Key (AK/SK).

  1. Log in to the console.

  2. On the management console, hover over the username in the upper right corner and choose My Credentials from the drop-down list.

  3. Choose Access Keys from the navigation pane.
  4. Click Create Access Key, and enter the login password and verification code.

  5. Click OK to generate an access key and download it.

    Keep your AK/SK secure since you need them to install the ICAgent.

Step 2: Installing the ICAgent

  1. Choose Service List > Management & Deployment > Log Tank Service.
  2. In the navigation pane, click Agent Management to go to the Agent Management page.
  3. Click Install ICAgent.
  4. Generate the ICAgent installation command.

    Installation mode is set to Obtain AK/SK by default. Enter the AK/SK obtained in 5 in the text box to generate the ICAgent installation command.

  5. Then, click Copy Command to copy the ICAgent installation command.

    Ensure that the AK/SK are correct. Otherwise, the ICAgent cannot be installed.

  6. Use a remote login tool, such as PuTTY, to log in to the server where the ICAgent is to be installed as the root user and run the preceding command to install the ICAgent.

    When the message "ICAgent install success" is displayed, the ICAgent is successfully installed in the /opt/oss/servicemgr/ directory.

  7. After the ICAgent is successfully installed, choose Agent Management in the LTS navigation pane to view the ICAgent status.

Step 3: Importing Collection Configuration Data

You can import the log collection information configured in the Telescope agent to the ICAgent. The ICAgent continues to collect logs based on the imported log collection information.

  1. On the Agent Management page, click the Telescope Agent tab page.
  2. Click to expand the instance, record information such as Log Format, Log Group Name, Log Stream Name, and Path.

  3. Click Import on the right to import the log collection information configured in the Telescope agent.

    • If there are multiple instances, perform the preceding steps to import them.
    • After the ICAgent is installed, both the Telescope agent and the ICAgent collect logs at the same time (parallel policy) to ensure that log data can be smoothly migrated, without being lost.

Step 4: Viewing Imported Logs

The collection configuration data will be imported 2 minutes later. You need to go to the corresponding log stream page to have a check.

  1. In the navigation pane, click Log Management to go to the Log Management page.
  2. In the log group list, click a log group recorded in 2. The log stream list page is displayed.
  3. In the log stream list, click a log stream recorded in 2. The Log Stream page is displayed.
  4. Click Collection Configuration and check whether the log collection configuration information, such as Log Format, Log Group Name, and Path, is consistent with that in the Telescope agent before.

  5. Click Real-Time Logs to view logs in real time.

    • Historical log data is automatically imported by the system.
    • If the log collection configuration data is inconsistent or no log data exists, the import fails. In this case, import the log collection configuration data again or contact Huawei technical support engineers.

Step 5: Deleting the Collection Path Configured in the Telescope Agent

After the log collection configuration data is imported successfully, delete the log collection instance from the Telescope agent. Otherwise, two log collectors exist at the same time. As a result, logs are repeatedly collected and reported.

  1. On the Agent Management page, click the Telescope Agent tab page.
  2. Click Delete next to the instance to delete the log collection information configured in the Telescope agent.

    The deletion operation indicates deleting the log collection path configured in the Telescope agent instead of uninstalling the Telescope agent. After the deletion, the Telescope agent will not report logs to LTS. To uninstall the Telescope, run the following command:

    /usr/local/telescope/uninstall.sh

Did you find this page helpful?

Submit successfully!

Thank you for your feedback. Your feedback helps make our documentation better.

Failed to submit the feedback. Please try again later.

Which of the following issues have you encountered?







Please complete at least one feedback item.

Content most length 200 character

Content is empty.

OK Cancel