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

    • 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 ...

    • 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.

    • 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.  ...

    • 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, ...

    • How to add an instance that was deleted earlier (For .NET and .NET Core agents)

      Steps for .NET agent Navigate to the path: %ProgramData%\DotNetAgent\ Delete the apminsight.net.info file from the folder with the same name as the application. Note: The name of the monitor folder created for the selected application will be same as ...