Add a deleted instance

How to add a PHP instance that was deleted earlier

For agent versions 4.0 and above

For every instance, there will be a corresponding configuration file present inside the conf folder of the S247DataExporter installation path. Delete the appropriate configuration file and restart the S247DataExporter (Linux | Windows) to re-add the deleted instance.
Do not delete the configuration.json file.
Please find the default conf folder paths below:
Linux: /opt/S247DataExporter/conf
Windows: C:\Program Files (x86)\S247DataExporter\conf

For agent versions below 4.0

Linux: 
  1. Delete the instance.out file from the following path:
    rm /opt/zpa/bin/instance.out

  2. Edit the apminsight.conf file in /opt/zpa/conf/ to rename the application name by editing the following line:
    #Logical name of your application
    application.name=PHP-Application

  3. Restart the PHP agent service in /opt/zpa/bin by using the following command:
    sh run.sh restart
Windows:
  1. Delete the instance.out file from the APM Insight installation directory. By default, this is found in C:\Program Files (x86)\APM Insight PHP Agent\zpa\bin\.

  2. Edit the apminsight.conf file located in the installation directory to rename the application name. By default, this is found in C:\Program Files (x86)\APM Insight PHP Agent\zpa\conf\.

  3. Restart the APM Insight PHP Agent Windows service.

    • Related Articles

    • Adding an APM instance that has been deleted earlier

      APM Insight agent state is maintained in 'apminsight.info' file (located in the directory where agent jar resides). Please delete this file and restart the server, this will add the APM instance successfully.

    • Customize URL names using PHP agent API

      With APM Insight PHP agent, you can customize URL names for your web transactions.  Here's how you can do it: Open the PHP script of the transaction for which you want to customize the URL. Add the following snippet in any part of the PHP script ...

    • Methods to upgrade PHP agent (Linux/Windows)

      PHP agent can be upgraded in 2 ways: Auto upgrade Manual upgrade Auto upgrade: When this feature is enabled, the latest version of the agent is automatically downloaded and deployed when it is made available After the deployment process is complete, ...

    • Automatically restart APM Insight PHP agent during system reboots

      To automatically restart APM Insight PHP agent during system reboots, use the below given steps: For systemd servers:  From APM Insight PHP agent version 2.8, agent will automatically start during server reboots for systemd supported Linux flavors.  ...

    • How to create a new instance after deleting the existing one?

      You can create a new Node.js instance after deleting the old instance using the steps below: Open the application root directory and navigate to the apminsightdata folder. Delete the apminsight.json file. Restart the Node.js application. When you ...