Troubleshooting Services Using System Health

The following procedures may be used to troubleshoot services using System Health:

Reviewing the Service Version and Status Using the System Health Tab

You are able to perform the following tasks using the System Health tab in the Home page:

  • Review the status of each service

  • Review the number of instances of each service running

  • Review the version of each service

  • Review the IP address of the host where the service is running


Note

In addition to using the System Health tab in the Home page to troubleshoot the controller services, you can also log into the host and access a developer console to perform the same tasks. For additional information, see .

Before You Begin

You must have successfully deployed the Cisco APIC-EM and it must be operational.

You must have administrator (ROLE_ADMIN) permissions to perform this procedure.

For information about the user permissions required to perform tasks using the Cisco APIC-EM, see the chapter, Managing Users and Roles in the Cisco Application Policy Infrastructure Controller Enterprise Module Configuration Guide.

    Step 1   Log into the controller to view the controller's GUI.
    Step 2   Click the System Health tab in the Home page to view information about the controller's health.

    The following information is displayed in the System Health tab.

    System (Host) Health Data

    Data displayed include:

    • Host IP address

    • CPU—Host CPU usage is displayed in MHZ. Both the currently used and available host CPU is displayed.

    • Memory—Host memory usage is displayed in GB. Both the currently used and available host memory is displayed.

    • Storage—Host storage usage is displayed in GB. Both the currently used and available host storage is displayed.

    Color indicates status for the above host data:

    • Green—Indicates proper usage and support.

    • Yellow—Indicates usage is approaching improper levels and triggers this warning (color change).

    • Red—Indicates a failure based upon the usage exceeding the maximum supported value.

    Additionally, a graphical representation of the above data over the last 24 hours is displayed in this tab. Moving your cursor or mousing over the graph displays a data summation for specific date and time.

    Note   

    By placing your cursor over (mouseover) a color warning in the window, further information about the warning or failure message appears.

    Application Health Data

    Displays applications available from the Navigation pane, and the services that support each application. For example, the Topology application accessible in the GUI is supported by topology-service.

    Color bars indicate the status for the applications and the supporting service(s):

    • Green —Indicates that an application instance is starting. An application instance is the aggregation of the service instances. You can configure a minimum or maximum number of service instances, as well as grow and harvest these service instances (spin up or spin down the services).

    • Yellow—Indicates application instance and its supporting service instance(s) are experiencing issues and triggers this warning (color change).

    • Red—Indicates a failure of the application instance and its supporting service instance(s). You can harvest a service instance and then regrow it using the GUI. If the service instance does not regrow using the GUI, then you can manually regrow it. When you harvest a service instance, the controller will determine which instance is regrown (load balancing among them).

    • Blue—Indicates an in-progress state for the application or service instance (growing or harvesting).

    Step 3   Review the status and version of each service and application listed in the System Health tab.
    What to Do Next

    If there are any problems with any of the services or applications, then review the following procedures to troubleshoot a service.

    Removing a Service Instance Using the System Health GUI

    You are able to remove or harvest a service instance manually by using the System Health tab in the controller's GUI. You may wish to harvest a service instance and then regrow (recreate) it to correct for a faulty or unstable service.


    Note

    In addition to using the System Health tab in the Home page to troubleshoot the controller services, you can also log into the host and access a developer console to perform the same tasks. For additional information, see .


    Caution

    Only advanced users should perform the tasks described in this procedure or attempt to troubleshoot the services.

    Before You Begin

    You must have successfully deployed the Cisco APIC-EM and it must be operational.

    You must have administrator (ROLE_ADMIN) permissions to perform this procedure.

    For information about the user permissions required to perform tasks using the Cisco APIC-EM, see the chapter, Managing Users and Roles in the Cisco Application Policy Infrastructure Controller Enterprise Module Configuration Guide.

      Step 1   Log into the controller to view the controller's GUI.
      Step 2   Click the System Health tab in the Home page to view information about the controller's health.

      For information about what is displayed in the System Health tab, see Reviewing the Service Version and Status Using the System Health Tab.

      Step 3   Review the list of operational services in the Systems Health tab.

      Each service is represented by a square. A green-tinged colored square represents an active instance of the service, and a red-tinged colored square represents a service with a faulty or failed instance. Squares without color represents inactive services (no instances initiated and running).

      Note   

      Placing your cursor over a square displays the version of the service, number of instances running, and host IP address where the service instance is running.

      Step 4   Locate the service where you want to manually remove (harvest) an instance of a service and click the subtraction sign (-) at the upper right.

      You are then prompted to confirm your action to remove a service instance.

      Step 5   Choose Yes in the dialog box to confirm that you want to remove an instance of the service.

      The instance of the service is then spun down.

      When the process is finished, the square representing the service instance is removed.

      What to Do Next

      Manage your services by either manually removing (harvesting) additional instances or growing (restoring) instances for the services.

      Creating a Service Instance Using the System Health GUI

      You are able to create or restore a service instance manually by using the System Health tab in the controller's GUI. You may wish to create or restore a service after previously harvesting or removing it for faulty or unstable behavior.


      Note

      In addition to using the System Health tab in the Home page to troubleshoot the controller services, you can also log into the host and access a developer console to perform the same tasks. For additional information, see .


      Caution

      Only advanced users should perform the tasks described in this procedure or attempt to troubleshoot the services.

      Before You Begin

      You must have successfully deployed the Cisco APIC-EM and it must be operational.

      You must have administrator (ROLE_ADMIN) permissions to perform this procedure.

      For information about the user permissions required to perform tasks using the Cisco APIC-EM, see the chapter, Managing Users and Roles in the Cisco Application Policy Infrastructure Controller Enterprise Module Configuration Guide.

        Step 1   Log into the controller to view the controller's GUI.
        Step 2   Click the System Health tab in the Home page to view information about the controller's health.

        For information about what is displayed in the System Health tab, see .

        Step 3   Review the list of operational services in the Systems Health tab.

        Each service is represented by a square. A green-tinged colored square represents an active instance of the service, and a red-tinged colored square represents a service with a faulty or failed instance. Squares without color represents inactive services (no instances initiated and running).

        Note   

        Placing your cursor over a square displays the version of the service, number of instances running, and host IP address where the service instance is running.

        Step 4   Locate the service where you want to manually create or restore an instance of a service and click the addition sign (+) at the upper right.

        You are then prompted to confirm your action to create or restore an instance.

        Step 5   Choose Yes in the dialog box to confirm that you want to create or restore an instance of the service.

        The instance of the service is then spun up.

        When the process is finished, the square representing the service instance is created.

        What to Do Next

        Manage your services by manually growing (restoring) additional instances or removing (harvesting) instances from the services.