7.6.3. Troubleshooting your dynamic plugin


Refer to this list of troubleshooting tips if you run into issues loading your plugin.

  • Verify that you have enabled your plugin in the console Operator configuration and your plugin name is the output by running the following command:

    $ oc get console.operator.openshift.io cluster -o jsonpath='{.spec.plugins}'
    • Verify the enabled plugins on the status card of the Overview page. You must refresh your browser if the plugin was recently enabled.
  • Verify your plugin service is healthy by:

    • Verifying your plugin pod status is running and your containers are ready.
    • Verifying the service label selector matches the pod and the target port is correct.
    • Curl the plugin-manifest.json from the service in a terminal on the console pod or another pod on the cluster.
  • Verify your ConsolePlugin resource name (consolePlugin.name) matches the plugin name used in package.json.
  • Verify your service name, namespace, port, and path are declared correctly in the ConsolePlugin resource.
  • Verify your plugin service uses HTTPS and service serving certificates.
  • Verify any certificates or connection errors in the console pod logs.
  • Verify the feature flag your plugin relies on is not disabled.
  • Verify your plugin does not have any consolePlugin.dependencies in package.json that are not met.

    • This can include console version dependencies or dependencies on other plugins. Filter the JS console in your browser for your plugin’s name to see messages that are logged.
  • Verify there are no typos in the nav extension perspective or section IDs.

    • Your plugin may be loaded, but nav items missing if IDs are incorrect. Try navigating to a plugin page directly by editing the URL.
  • Verify there are no network policies that are blocking traffic from the console pod to your plugin service.

    • If necessary, adjust network policies to allow console pods in the openshift-console namespace to make requests to your service.
  • Verify the list of dynamic plugins to be loaded in your browser in the Console tab of the developer tools browser.

    • Evaluate window.SERVER_FLAGS.consolePlugins to see the dynamic plugin on the Console frontend.
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 문서 정보

Legal Notice

Theme

© 2026 Red Hat
맨 위로 이동