| Table of Contents |
|---|
Diagnostics
The two "halves" of the SP software write to separate diagnostic log files by default, as configured by the shibd.logger and native.logger logging setup files. Some native.log messages will also be routed to the web server's own log or the Windows error log.
| Tip |
|---|
It's common, particularly on non-Windows platforms, for the web server "half" to produce no dedicated logging because of Apache's restricted permissions. If you don't see that log, you'll have to adjust file permissions so that the Apache user account (typically "www", "apache", or "nobody") has the ability to create and write to files in the necessary directory. |
Most of the interesting and relevant information will usually be found in the shibd.log, particularly SAML-related problems, Metadata issues, and most security issues. It's somewhat rare to actually need the native.log (which is one reason the permission issue noted above has never been seriously addressed). Under routine use, very little ends up in that log (or at least not only there), but one common problem that may depend on using it is the pass-through issue.
The primary control point for logging is to set the logging level of the "root" logging category, which is the first non-comment line in the logger configuration files. To pick up a change, you will usually need to restart the process involved.
The typical logging levels can be described thusly:
...
A third log is configured from within the shibd.logger setup file, and typically available in transaction.log.
...
Each session that's created or removed is logged here along with a variety of general information, including the set of attributes obtained (but not their values). Apart from auditing or tracking down users, the main value of this information is to identify whether the SP received particular attributes or not. If you don't see something here, and there are no ERROR or WARN messages in shibd.log regarding query failures or filtering, then the attribute in question simply wasn't given to the SP.
...