IMPORTANT: The method of configuring logging levels per connector that is described in this document has been been updated. Logging functionality is now configurable by API. For more information, refer to the Enabling Connector Logging in IdentityNow Compass page.
IdentityNow's VA has the ability for the SailPoint user to directly configure logging levels per connector by setting connector class log levels.
This is very beneficial as the standard debug option (Connections -> Virtual Appliances -> Cluster -> Enable Debugging) is not sustainable due to the amount of information it delivers. The CCG logs on the VA can be found at /home/sailpoint/log.
The Cloud Connector Gateway (CCG) uses either log4j or log4j2 to log information about the connector operations it is performing and each logger has its own logging configuration format. Log4j uses a properties file where log4j2 configuration uses XML. The format of the logging configuration that will need to be updated will depend on the version of the CCG running on your VA. An example of each file type is attached to this document.
The following are the examples of loggers.
The difference in syntax between log4j and log4j2 is straight forward. The log4j config will have a property value similar to:
log4j.logger.sailpoint.connector.ADLDAPConnector=debug
Log4j2 will have an XML element similar to:
<Logger name="sailpoint.connector.ADLDAPConnector" level="debug" />
Connector | Logger Path |
Active Directory-Direct | logger.ADLDAPConnector.name = sailpoint.connector.ADLDAPConnector
logger.ADLDAPConnector.level = debug
logger.LDAPConnector.name = sailpoint.connector.LDAPConnector |
AIX - Direct |
logger.UnixConnector.name = openconnector.connector.unix.UnixConnector logger.AIXConnector.name = openconnector.connector.unix.AIXConnector
|
Amazon Web Services |
logger.aws.name=openconnector.connector.aws logger.aws.additivity = false
|
Azure AD | logger.AzureADConnector.name = sailpoint.connector.AzureADConnector logger.AzureADConnector.level = debug logger.AzureADConnector.additivity = false logger.AzureADConnector.appenderRef.rolling.ref = STDOUT |
Box | logger.BoxNetConnector.name = openconnector.connector.BoxNetConnector logger.BoxNetConnector.level = debug logger.BoxNetConnector.additivity = false logger.BoxNetConnector.appenderRef.rolling.ref = STDOUT |
Cerner | logger.CernerConnector.name = openconnector.connector.CernerConnector logger.CernerConnector.level = debug logger.CernerConnector.additivity = false logger.CernerConnector.appenderRef.rolling.ref = STDOUT |
DelimitedFile | logger.DelimitedFileConnector.name = sailpoint.connector.DelimitedFileConnector logger.DelimitedFileConnector.level = debug logger.DelimitedFileConnector.additivity = false logger.DelimitedFileConnector.appenderRef.rolling.ref = STDOUT
|
Drop Box |
logger.DropBoxConnector.name = openconnector.connector.DropBoxConnector
|
Epic | logger.EPICConnector.name = openconnector.connector.EPICConnector logger.EPICConnector.level = debug logger.EPICConnector.additivity = false logger.EPICConnector.appenderRef.rolling.ref = STDOUT
|
GE Centricity | logger.GECentricity.name = openconnector.connector.GECentricity logger.GECentricity.level = debug logger.GECentricity.additivity = false logger.GECentricity.appenderRef.rolling.ref = STDOUT |
Gsuite/GoogleApps |
logger.GoogleAppsDirect.name = openconnector.connector.GoogleAppsDirect logger.OpenConnectorAdapter.name = sailpoint.connector.OpenConnectorAdapter |
IBM i |
logger.IBMiConnector.name = openconnector.connector.IBMiConnector |
IBM Lotus Domino | logger.LotusDomino.name = sailpoint.connector.LotusDomino logger.LotusDomino.level = debug logger.LotusDomino.additivity = false logger.LotusDomino.appenderRef.rolling.ref = STDOUT |
JDBC | logger.JDBCConnector.name = sailpoint.connector.JDBCConnector logger.JDBCConnector.level = debug logger.JDBCConnector.additivity = false logger.JDBCConnector.appenderRef.rolling.ref = STDOUT |
LDAP/SUNONE | logger.LDAPConnector.name = sailpoint.connector.LDAPConnector logger.LDAPConnector.level = debug logger.LDAPConnector.additivity = false logger.LDAPConnector.appenderRef.rolling.ref = STDOUT |
Linux - Direct |
logger.UnixConnector.name = sailpoint.connector.UnixConnector logger.LinuxConnector.name = openconnector.connector.unix.LinuxConnector |
Microsoft Office365 | logger.Office365Connector.name = sailpoint.connector.Office365Connector logger.Office365Connector.level = debug logger.Office365Connector.additivity = false logger.Office365Connector.appenderRef.rolling.ref = STDOUT |
Microsoft SQL Server – Direct |
logger.SQLServerConnectorV2.name = sailpoint.connector.mssql.serviceimpl.MSSQLServerConnectorV2 |
Okta |
logger.openconnector.name = openconnector.connector.okta.OktaConnector |
Oracle Database - Direct |
logger.OracleDBConnector.name = sailpoint.connector.OracleDBConnector |
Oracle E-Business |
logger.OracleEBSConnector.name = sailpoint.connector.OracleEBSConnector |
Oracle Fusion HCM |
logger.oracleHCM.name=openconnector.connector.oraclefusionhcm.OracleFusionHCMConnector Package : openconnector.connector.oraclefusionhcm Connector class : openconnector.connector.oraclefusionhcm.OracleFusionHCMConnector
|
Oracle HRMS |
logger.OracleAppsHRMSConnector.name = sailpoint.connector.OracleAppsHRMSConnector |
PeopleSoft - Direct |
logger.PeopleSoftConnector.name = openconnector.connector.PeopleSoftConnector |
PeopleSoftHRMS - Direct | logger.PeopleSoftHRMSConnector.name = sailpoint.connector.PeopleSoftHRMSConnector logger.PeopleSoftHRMSConnector.level = debug logger.PeopleSoftHRMSConnector.additivity = false logger.PeopleSoftHRMSConnector.appenderRef.rolling.ref = STDOUT
|
RemedyForce | logger.ForceConnector.name = sailpoint.connector.ForceConnector logger.ForceConnector.level = debug logger.ForceConnector.additivity = false logger.ForceConnector.appenderRef.rolling.ref = STDOUT |
RSA Authentication Manager |
logger.RSAConnector.name = sailpoint.connector.RSAConnector logger.RSAHTTPClient.name = sailpoint.connector.rsa.RSAHTTPClient
|
Salesforce | logger.SalesForceConnector.name = sailpoint.connector.SalesForceConnector logger.SalesForceConnector.level = debug logger.SalesForceConnector.additivity = false logger.SalesForceConnector.appenderRef.rolling.ref = STDOUT |
SAP - Direct |
logger.SAPConnector.name = sailpoint.connector.SAPConnector logger.SAPInternalConnector.name = sailpoint.connector.SAPInternalConnector |
SAP - GRC |
logger.SAPGRCConnector.name = sailpoint.connector.sapgrc logger.SAPGRCConnector.additivity = false
|
SAP HR/HCM |
logger.SAPHRInternalConnector.name = sailpoint.connector.SAPHRInternalConnector |
SCIM1 | logger.SCIMConnector.name = openconnector.connector.SCIMConnector logger.SCIMConnector.level = debug logger.SCIMConnector.additivity = false logger.SCIMConnector.appenderRef.rolling.ref = STDOUT |
SCIM2.0 |
logger.SCIM2Connector.name = openconnector.connector.scim2.SCIM2Connector Package: openconnector.connector.scim2 Connector class : openconnector.connector.scim2.SCIM2Connector |
ServiceNow | logger.servicenow.name = openconnector.connector.servicenow.ServiceNowConnector logger.servicenow.level = debug logger.servicenow.additivity = false logger.servicenow.appenderRef.rolling.ref = STDOUT logger.ServiceNowRestClient.name = openconnector.connector.servicenow.ServiceNowRestClient logger.ServiceNowRestClient.level = debug logger.ServiceNowRestClient.additivity = false logger.ServiceNowRestClient.appenderRef.rolling.ref = STDOUT |
ServiceNow Integration | logger.servicedesk.name = openconnector.connector.servicedesk.ServiceNowServiceDeskConnector logger.servicedesk.level = debug logger.servicedesk.additivity = false logger.servicedesk.appenderRef.rolling.ref = STDOUT |
Siebel |
logger.SiebelConnector.name = openconnector.connector.SiebelConnector |
Solaris - Direct |
logger.unix.name = openconnector.connector.unix.UnixConnector logger.SolarisConnector.name = openconnector.connector.unix.SolarisConnector |
SuccessFactors - Direct |
logger.SuccessFactorsConnector.name = sailpoint.connector.SuccessFactorsConnector |
Sybase - Direct |
logger.SybaseDirectConnector.name = sailpoint.connector.SybaseDirectConnector
|
Webex |
logger.Webex.name = openconnector.connector.Webex |
Workday |
logger.WorkDay.name = openconnector.connector.WorkDay Package : openconnector.connector.workday Connector class : openconnector.connector.WorkDay |
Workday Accounts |
logger.workdayaccounts.name = openconnector.connector.workdayaccounts Package: openconnector.connector.workdayaccounts Connector class : openconnector.connector.workdayaccounts.WorkdayAccountsConnector |
Web Services | logger.webservices.name = sailpoint.connector.webservices logger.webservices.level = debug logger.webservices.additivity = false logger.webservices.appenderRef.rolling.ref = STDOUT |
XML | logger.XMLConnector.name = openconnector.connector.XMLConnector logger.XMLConnectorlevel = debug logger.XMLConnector.additivity = false logger.XMLConnector.appenderRef.rolling.ref = STDOUT |
Yammer | logger.YammerConnector.name = openconnector.connector.YammerConnector logger.YammerConnector.level = debug logger.YammerConnector.additivity = false logger.YammerConnector.appenderRef.rolling.ref = STDOUT |
Zoom |
logger.zoomname = openconnector.connector.zoom Package : openconnector.connector.zoom Connector class : openconnector.connector.zoom.ZoomConnector |
Purpose | Logging Class |
HTTP posts back to cloud stack | log4j.logger.sailpoint.gateway.accessiq.AggregateHandler = debug |
HTTP request/response for connectors | log4j.logger.httpclient.wire=debug
log4j.logger.connector.common.http=debug |
Hi,
What is the Logger Path for SharePoint Online?
Thanks,
Gustavo
Can you please update this page with new syntax for log4j2.properties?
example, for ad it is:
logger.ad_connector.name = sailpoint.connector.ADLDAPConnector
logger.ad_connector.level = debug
Also remember to enable debugging on the VA cluster via 'Connections --> Virtual Appliances --> Enable Debugging'
logger.sdk.name =connector.sdk.webservices
logger.sdk.level = debug
logger.sdk.additivity = false
logger.sdk.appenderRef.rolling.ref = STDOUT
logger.http.name = connector.common.http
logger.http.level = debug
logger.http.additivity = false
logger.http.appenderRef.rolling.ref = STDOUT
For webservices, apart from the one mentioned we can use above classes for more information.
My VA uses log4j2.properties. This guide needs to be updated.
What are the logger paths for VA executed Rules such as BeforeProvisioningRule or WebServiceBeforeOperation Rule?
What is the command to Save the log4j2.properties file.
Here is a link to the Doc for using the APIs to enable Connecor logging
Could somebody let me know the connector class name for Atlassian Suite Server?
Hello,
Is there a connector class name for SQL Loader connection ?
Thanks.
Logger for NetSuite:
logger.sp_connector.name =openconnector.connector.netsuite.NetsuiteConnector
logger.sp_connector.level = trace
Hello folks!
Is possible to generate an independent file -logging levels- per connector (application) integrated in SailPoint IIQ 8.3.1?
Hi All,
What should be the logger for SAP Concur connector?
Share Point Loggerslogger.connector_O365SharepointOnlineConnector.name=sailpoint.connector.O365SharepointOnlineConnector
logger.connector_O365SharepointOnlineConnector.level=debug
logger.sharepointonline_SPOConnectionManager.name=sailpoint.connector.sharepointonline
logger.sharepointonline_SPOConnectionManager.level=debug
@ukputta loggers for SAP Concor -
openconnector.connector.sapconcur.SAPConcurConnector
For Oracle HCM Cloud, use
```
logger.connector_OracleHCMCloud.name=openconnector.connector.oraclehcmcloud
logger.connector_OracleHCMCloud.level=debug
logger.connector_OracleHCMCloud.additivity = false
logger.connector_OracleHCMCloud.appenderRef.rolling.ref = STDOUT
```
ok, article is kind of nice, but config files are owned by root, you cant change them, right?
@sergiyshpak sudo chown -r sailpoint /home/sailpoint/ccg
does anyone have sudo rights?
what happens if directory changes owner? original process wont be able access that place, right?
@sergiyshpak you can check `sudo -l` for a listing of what commands the sailpoint user has sudoers access to call.
it is rather restricted in terms of what you have the ability to sudo.
What is the logging class to be used for SAP Fieldglass connector.
What are the logger paths for VA executed Rules such as BeforeProvisioningRule or WebServiceBeforeOperation Rule?
I have added below logger, but WebServiceBeforeOperation logs are not printing.
logger.webservices.name = sailpoint.connector.webservices
logger.webservices.level = debug
logger.webservices.additivity = false
logger.webservices.appenderRef.rolling.ref = STDOUT