{"id":110579,"date":"2024-05-20T16:31:46","date_gmt":"2024-05-20T20:31:46","guid":{"rendered":"https:\/\/jumpcloud.com\/?post_type=support&p=110579"},"modified":"2024-05-21T09:48:25","modified_gmt":"2024-05-21T13:48:25","slug":"enable-debug-logging-for-the-active-directory-integration","status":"publish","type":"support","link":"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration","title":{"rendered":"Enable Debug Logging for the Active Directory Integration"},"content":{"rendered":"\n

This article explains how to enable and disable debug level logging for the JumpCloud Active Directory Integration (ADI) Import and Sync agents.<\/p>\n\n\n\n

Enabling Debug Logging for the Import Agent<\/h2>\n\n\n\n
    \n
  1. Open your favorite text editor (Notepad or Notepad++) with elevated permissions.<\/li>\n\n\n\n
  2. Locate the Active Directory Import Configuration File. The file location varies based on the version of the Import agent you have installed:\n
      \n
    • Version 1.7.4<\/strong>: C:\\Program Files\\JumpCloud AD Bridge\\adint.config.json<\/li>\n\n\n\n
    • Version 1.11.0 and later<\/strong>: C:\\Program Files\\JumpCloud\\AD Integration\\JumpCloud AD Import\\jcadimportagent.config.json
      <\/li>\n<\/ul>\n<\/li>\n\n\n\n
    • Locate the following section in the configuration file. These are the default logging settings:<\/li>\n<\/ol>\n\n\n\n
      \n

      “Debug”: {
      “Debugs”: {
      “adquery.go”: 0,
      “debug.go”: 0,
      “jcmap.go”: 0
      }
      }, <\/p>\n<\/div><\/div>\n\n\n\n

        \n
      1. To enable debug logging, replace the settings in the previous step with the following:<\/li>\n<\/ol>\n\n\n\n
        \n

        “Debug”: {
        “Debugs”: {
        “adquery.go”: 4,
        “debug.go”: 4,
        “jcmap.go”: 4,
        “adquery.go”: 4,
        “api_client.go”: 4,
        “jcapi-groups.go”: 4,
        “passwordchg.go”: 100
        }
        }, <\/p>\n<\/div><\/div>\n\n\n\n

          \n
        1. Restart the JumpCloud AD Integration Import agent service.<\/li>\n<\/ol>\n\n\n\n

          The following Import agent log excerpt shows debug level logging enabled:<\/p>\n\n\n\n

          \n

          Log Example Showing Debug Levels Enabled

          ADINT:2021\/02\/25 07:10:33 debug.go:21: Debug Settings
          ADINT:2021\/02\/25 07:10:33 debug.go:22: ————–
          ADINT:2021\/02\/25 07:10:33 debug.go:25: adquery.go=4
          ADINT:2021\/02\/25 07:10:33 debug.go:25: debug.go=4
          ADINT:2021\/02\/25 07:10:33 debug.go:25: jcmap.go=0
          ADINT:2021\/02\/25 07:10:33 service.go:67: Starting up. Version = v1.7.1
          ADINT:2021\/02\/25 07:10:33 service.go:88: Ready to process commands
          ADINT:2021\/02\/25 07:10:33 adint.go:136:<\/p>\n<\/div><\/div>\n\n\n\n

            \n
          1. (Optional) To disable debug logging, replace the settings with the original settings shown in step 3, and then restart the JumpCloud ADI Import agent service.<\/li>\n<\/ol>\n\n\n\n

            Enabling Debug Logging for the Sync Agent<\/h2>\n\n\n\n

            Unlike the ADI Import agent, the Sync agent\u2019s settings all reside in the Windows Registry. To enable Debug for AD Sync, a new registry key must be created.<\/p>\n\n\n\n

            <\/p><\/div>

            Warning:<\/strong> \n

            Exercise extreme caution when using the Registry Editor. If you edit the registry incorrectly, serious problems can occur that could require a complete reinstall of the operating system and result in data loss.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n

              \n
            1. Open the Registry Editor and go to the following location based on your Sync agent version:\n
                \n
              • Version 2.26.0<\/strong>: HKEY_LOCAL_MACHINE\\SOFTWARE\\JumpCloud\\AD Sync.<\/li>\n\n\n\n
              • Version: 4.3.1 and later<\/strong>: HKEY_LOCAL_MACHINE\\SOFTWARE\\JumpCloud\\AD Integration Sync Agent.\n
                  \n
                • Example image from v2.26.0:
                  \"The<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                • Right-click the appropriate key AD Sync<\/strong> (v2.26.0) or AD Integration Sync Agent<\/strong> (v4.3.1+) and select New<\/strong> > Key<\/strong>.<\/li>\n\n\n\n
                • Name this new key: log<\/strong><\/kbd>.<\/li>\n\n\n\n
                • Under the log<\/strong> key, create a new string value titled: level<\/strong><\/kbd>. Set the value for this string to debug<\/strong>.<\/li>\n\n\n\n
                • Once complete, restart the MS Service: JumpCloud AD Integration Sync Agent.<\/li>\n\n\n\n
                • (Optional) To disable debug logging, change the value from \u2018debug\u2019 to \u2018info\u2019, and restart the agent service.<\/li>\n<\/ol>\n\n\n\n

                  The following Sync agent log excerpt shows debug level logging enabled:<\/p>\n\n\n\n

                  \n

                  Log Example Showing Debug Levels Enabled

                  25T07:20:18.7990398-08:00″,”tls”:{“ca”:”present”,”certs”:”present”,”server_name”:”adbridge.jumpcloud.com”}}<\/span>
                  {“level”:”info”,”msg”:”opening new connection”,”target”:”adbridge.jumpcloud.com”,”time”:”2021-02-25T07:20:18.7990398-08:00″}
                  {“level”:”debug”,”msg”:”running report”,”time”:”2021-02-25T07:20:18.8102447-08:00″}
                  {“level”:”info”,”msg”:”running system report”,”time”:”2021-02-25T07:20:18.8102447-08:00″}
                  {“level”:”debug”,”msg”:”running *systemreport.hostnameCollector”,”time”:”2021-02-25T07:20:18.8102447-08:00″}
                  {“level”:”debug”,”msg”:”running *systemreport.ipCollector”,”time”:”2021-02-25T07:20:18.8102447-08:00″}<\/p>\n<\/div><\/div>\n","protected":false},"excerpt":{"rendered":"

                  This article explains how to enable and disable debug level logging for the JumpCloud Active Directory Integration (ADI) Import and […]<\/p>\n","protected":false},"author":218,"featured_media":0,"template":"","meta":{"_acf_changed":false,"_oasis_is_in_workflow":0,"_oasis_original":0,"_oasis_task_priority":"","inline_featured_image":false,"footnotes":""},"support_category":[2904,2855,3135,2954,3127],"support_tag":[],"coauthors":[3011],"acf":[],"yoast_head":"\nEnable Debug Logging for the Active Directory Integration<\/title>\n<meta name=\"description\" content=\"Learn how to enable debug level logging for the JumpCloud Active Directory Integration (ADI) Import and Sync agents.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Enable Debug Logging for the Active Directory Integration\" \/>\n<meta property=\"og:description\" content=\"Learn how to enable debug level logging for the JumpCloud Active Directory Integration (ADI) Import and Sync agents.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration\" \/>\n<meta property=\"og:site_name\" content=\"JumpCloud\" \/>\n<meta property=\"article:modified_time\" content=\"2024-05-21T13:48:25+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/05\/ad_sync_debug_level_logging_in_windows_registry_editor.jpg\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"nickconrad\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration\",\"url\":\"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration\",\"name\":\"Enable Debug Logging for the Active Directory Integration\",\"isPartOf\":{\"@id\":\"https:\/\/jumpcloud.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration#primaryimage\"},\"image\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration#primaryimage\"},\"thumbnailUrl\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/05\/ad_sync_debug_level_logging_in_windows_registry_editor.jpg\",\"datePublished\":\"2024-05-20T20:31:46+00:00\",\"dateModified\":\"2024-05-21T13:48:25+00:00\",\"description\":\"Learn how to enable debug level logging for the JumpCloud Active Directory Integration (ADI) Import and Sync agents.\",\"breadcrumb\":{\"@id\":\"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration#primaryimage\",\"url\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/05\/ad_sync_debug_level_logging_in_windows_registry_editor.jpg\",\"contentUrl\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/05\/ad_sync_debug_level_logging_in_windows_registry_editor.jpg\",\"width\":619,\"height\":407,\"caption\":\"The debug level log setting for the AD Sync agent in the Windows Registry Editor.\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/jumpcloud.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Support\",\"item\":\"https:\/\/jumpcloud.com\/support\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Enable Debug Logging for the Active Directory Integration\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/jumpcloud.com\/#website\",\"url\":\"https:\/\/jumpcloud.com\/\",\"name\":\"JumpCloud\",\"description\":\"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.\",\"publisher\":{\"@id\":\"https:\/\/jumpcloud.com\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/jumpcloud.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/jumpcloud.com\/#organization\",\"name\":\"JumpCloud\",\"url\":\"https:\/\/jumpcloud.com\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"contentUrl\":\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png\",\"width\":598,\"height\":101,\"caption\":\"JumpCloud\"},\"image\":{\"@id\":\"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Enable Debug Logging for the Active Directory Integration","description":"Learn how to enable debug level logging for the JumpCloud Active Directory Integration (ADI) Import and Sync agents.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration","og_locale":"en_US","og_type":"article","og_title":"Enable Debug Logging for the Active Directory Integration","og_description":"Learn how to enable debug level logging for the JumpCloud Active Directory Integration (ADI) Import and Sync agents.","og_url":"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration","og_site_name":"JumpCloud","article_modified_time":"2024-05-21T13:48:25+00:00","og_image":[{"url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/05\/ad_sync_debug_level_logging_in_windows_registry_editor.jpg"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes","Written by":"nickconrad"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration","url":"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration","name":"Enable Debug Logging for the Active Directory Integration","isPartOf":{"@id":"https:\/\/jumpcloud.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration#primaryimage"},"image":{"@id":"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration#primaryimage"},"thumbnailUrl":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/05\/ad_sync_debug_level_logging_in_windows_registry_editor.jpg","datePublished":"2024-05-20T20:31:46+00:00","dateModified":"2024-05-21T13:48:25+00:00","description":"Learn how to enable debug level logging for the JumpCloud Active Directory Integration (ADI) Import and Sync agents.","breadcrumb":{"@id":"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration#primaryimage","url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/05\/ad_sync_debug_level_logging_in_windows_registry_editor.jpg","contentUrl":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/05\/ad_sync_debug_level_logging_in_windows_registry_editor.jpg","width":619,"height":407,"caption":"The debug level log setting for the AD Sync agent in the Windows Registry Editor."},{"@type":"BreadcrumbList","@id":"https:\/\/jumpcloud.com\/support\/enable-debug-logging-for-the-active-directory-integration#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/jumpcloud.com\/"},{"@type":"ListItem","position":2,"name":"Support","item":"https:\/\/jumpcloud.com\/support"},{"@type":"ListItem","position":3,"name":"Enable Debug Logging for the Active Directory Integration"}]},{"@type":"WebSite","@id":"https:\/\/jumpcloud.com\/#website","url":"https:\/\/jumpcloud.com\/","name":"JumpCloud","description":"Daily insights on directory services, IAM, LDAP, identity security, SSO, system management (Mac, Windows, Linux), networking, and the cloud.","publisher":{"@id":"https:\/\/jumpcloud.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/jumpcloud.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/jumpcloud.com\/#organization","name":"JumpCloud","url":"https:\/\/jumpcloud.com\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/","url":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","contentUrl":"https:\/\/jumpcloud.com\/wp-content\/uploads\/2021\/01\/jc-logo-brand-2021.png","width":598,"height":101,"caption":"JumpCloud"},"image":{"@id":"https:\/\/jumpcloud.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/110579"}],"collection":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support"}],"about":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/types\/support"}],"author":[{"embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/users\/218"}],"version-history":[{"count":3,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/110579\/revisions"}],"predecessor-version":[{"id":110621,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support\/110579\/revisions\/110621"}],"wp:attachment":[{"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/media?parent=110579"}],"wp:term":[{"taxonomy":"support_category","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_category?post=110579"},{"taxonomy":"support_tag","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/support_tag?post=110579"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/jumpcloud.com\/wp-json\/wp\/v2\/coauthors?post=110579"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}