Configure Apache integration

To integrate Apache with SolarWinds Observability SaaS:

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

2. In the Add Data dialog Intro, click the Integrations tab, 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.

   To only display Agents running in a Kubernetes cluster, click the List only Agents... toggle.

   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 Run the SolarWinds Observability Agent as a Docker image or Kubernetes deployment.

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

   • 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. If you want to relate Apache data to other entity, associate the entities.

   For example, if there is a website or a service running on the Apache server you are integrating, you might want to relate the data collected by the Apache server to the website or service. To do so, specify one or more entities to be associated with the data collected by the Apache integration and click Deploy.

   • Select the entity type and the entity you want to associate with the Apache server entity.
   • To associate more entities, click Add New Association, specify the entity type and entity for each association.

   When you associate entities with the Apache integration, the ID of the selected entity will be added to telemetry data. You can thus see relevant data collected by the Apache integration when viewing details for the entity, such as a website or a service.

   If you don't want to associate any entities, click Deploy to deploy the changes to the agent.

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

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