Configure Apache integration

To integrate Apache with SolarWinds Observability:

1. In SolarWinds Observability, click Add Data at the top.

2. In the Add Data dialog, click Integration, and then click Apache.

3. In the Add Apache dialog, select a host with the SolarWinds Observability Agent you want to use for Apache and click Next.

   If you want to install a dedicated Agent on a dedicated host, add the host and then add the Apache integration. See Add a self-managed host.

   If you prefer using Docker, see Install SolarWinds Observability Agent as a Docker image.

4. Select where the Apache service is located:

   • On Host: The Apache service runs on the same physical or virtual machine as the Agent.

   • Off Host: The Apache service runs on a different physical or virtual machine than the Agent.

5. Make sure that Apache is ready to be integrated. Apache must expose status information.

   1. Run a command to check that the status module is enabled.

   apachectl -t -D DUMP_MODULES | grep status_module

   2. Search for with-http_stub_status_module in the output. If the output file doesn't include it, enable the mod_status module. Refer to Apache documentation for details.

   3. Open the Apache configuration file status.conf and make sure the mod_status module is enabled. By default, the configuration file is located at /etc/apache2/mods-enabled/.

      The mod_status module configuration file name and location might be different, based on your Linux distribution.

      • /etc/apache2/httpd.conf
      • /etc/apache2/apache2.conf
      • /etc/httpd/httpd.conf
      • /etc/httpd/conf/httpd.conf

      Example: enabled mod_status module

      <Location /server-status>
          SetHandler server-status
          Require local
      </Location>
      
      ExtendedStatus On

   4. Run the following command to check the Apache configuration file for errors. If there are errors, resolve them.

      apachectl -t

   5. If there are no errors, restart the Apache service using this command.

      apachectl restart

   6. Run the command to call the status URL. The call should return basic status data.

      curl http://localhost:80/server-status

   7. Click Next.

6. Review the configuration and click Deploy to deploy the changes to the agent.

   • Provide a Display Name.

   • Review the Apache Endpoint.

   • Review the Collection Interval.

   • For On Host integrations, you can collect logs. Click Enable log monitoring and configure logs.

7. Optional for On Host integrations: Configure logs.

   If you enabled logs:

   1. Grant the Agent access to the Apache log folder. Use the following command:

      sudo usermod -a -G adm swagent

   2. Restart the Agent. Run the following command.

      sudo service uamsclient restart

   3. Review the default path for storing logs. Adjust it if appropriate.

8. When the installation is complete, you can continue to observe Apache data. Use the buttons on the Summary screen.

To view data collected for the newly configured entity in the Entity Explorer, click the name of the Apache instance in the confirmation dialog in the lower-left corner. It may take a few seconds for data to appear for the newly created entity. See Entity Explorer for details.