Migrating log collection integrations from BMC Helix Developer Tools

Use collection policies to migrate your log collection integrations from BMC Helix Developer Tools to BMC Helix Log Analytics. You must first migrate the connectors and then migrate the integrations. Log collection starts after you migrate the integrations and enable the policy.

Related topic

Support-information

To migrate connectors

  1. Go to BMC Helix Developer Tools and note the connector details that you want to migrate; for example name and type of the connector.
  2. For the Docker connector, perform the following steps:
    1. Run the following command: docker ps.
      Container details are displayed.
    2. Note the container ID of the integration that you are migrating.
    3. Stop and delete the container by running the following commands:
      docker stop <container ID>
      docker rm <container ID>
  3. For the Linux connector, perform the following steps:
    1. To stop the td-agent service, run the following command: systemctl stop td-agent.service.
    2. To disable the td-agent service, run the following command: systemctl disable td-agent.service.
    3. To remove the td-agent service, run the following command: rm -rf /etc/systemd/system/td-agent.service.
    4. To reload the daemon, run the following command: systemctl daemon-reload.
    5. To remove the td-agent directory, run the following command: rm -rf /opt/td-agent. 
  4. For the Windows connector, delete the service created with the name of the integration by running the following command on the command prompt: sc delete <service name>.
  5. Delete the existing integration.

  6. In BMC Helix Log Analytics, create a connector.

    Important

    If you are migrating log collection from BMC Helix Developer Tools, ensure that the connector name is not same as the integration name in BMC Helix Developer Tools.

    While collecting logs from Kubernetes, do not use the BMC Helix Developer Tools integration name as connector name BMC Helix Log Analytics.

    For more information, see Installing-and-managing-connectors.

  7. In BMC Helix Log Analytics, click Collection and then click Connectors and make sure that the connector state is Active.

To migrate integrations

  1. Go to BMC Helix Developer Tools and note the integration details, for example, name, parsing, filtering, and log source configurations.
  2. Go to  BMC Helix Log Analytics and create a parsing rule.
    For more information, see Creating-a-parsing-rule.
  3. Create a filtering rule.
    For more information, see Creating-a-filtering-rule.
  4. Create a collection policy.
    For more information, see Creating-collection-policies. Log collection starts after you enable the policy.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*