Debugging AEM SDK using the OSGi web console

Last update: March 23, 2025
  • Applies to:
  • Experience Manager as a Cloud Service

CREATED FOR:

  • Beginner
  • Intermediate
  • Developer

The AEM SDK’s local quickstart has an OSGi web console that provides a variety of information and introspections into the local AEM runtime that are useful to understand how your application is recognized by, and functions within AEM.

AEM provides many OSGi consoles, each providing key insights into different aspects of AEM, however the following are typically the most useful in debugging your application.

Bundles

The Bundles console is a catalog of the OSGi bundles, and their details, deployed to AEM, along with the ad hoc ability to start and stop them.

The Bundles console is located at:

Clicking into each bundle, provides details that help with the debugging your application.

  • Validating the OSGi bundle is present
  • Validating if an OSGi bundle is active
  • Determining if an OSGi bundle has unsatisfied imports preventing it from starting

Components

The Components console is a catalog of all the OSGi components deployed to AEM, and provides a all information about them, from their defined OSGi component life cycle, to what OSGi services they may reference to

The Components console is located at:

Key aspects that help with the debugging activities:

  • Validating the OSGi bundle is present
  • Validating if an OSGi bundle is active
  • Determining if an OSGi bundle has unsatisfied imports preventing it from starting
  • Obtaining the component’s PID, in order create OSGi configurations for them in Git
  • Identifying OSGi property values bound to the active OSGi configuration