From 2fde529d38af121d9e984ddc26e2fe7bfc7f66c2 Mon Sep 17 00:00:00 2001 From: Brett Date: Fri, 7 Mar 2025 15:22:46 -0500 Subject: [PATCH] rename logging_configuration to logging --- docs/index.rst | 2 +- docs/jwst/stpipe/user_logging.rst | 27 ------------- ...{logging_configuration.rst => logging.rst} | 39 +++++++++++++++++-- 3 files changed, 37 insertions(+), 31 deletions(-) rename docs/jwst/user_documentation/{logging_configuration.rst => logging.rst} (67%) diff --git a/docs/index.rst b/docs/index.rst index c51cda9918..91c75941f5 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -55,7 +55,7 @@ is also available on `JDox `__. jwst/user_documentation/running_pipeline_command_line.rst jwst/user_documentation/available_pipelines.rst jwst/user_documentation/input_output_file_conventions.rst - jwst/user_documentation/logging_configuration.rst + jwst/user_documentation/logging.rst jwst/user_documentation/datamodels.rst jwst/user_documentation/pub_deprecation.rst jwst/user_documentation/more_information.rst diff --git a/docs/jwst/stpipe/user_logging.rst b/docs/jwst/stpipe/user_logging.rst index d1d6f53b07..9c42b5433c 100644 --- a/docs/jwst/stpipe/user_logging.rst +++ b/docs/jwst/stpipe/user_logging.rst @@ -109,30 +109,3 @@ hitting any warning for that Step: level = INFO break_level = WARNING -.. _cal_logs: - -DataModel cal_logs -================== - -Saved files that contain :ref:`jwst-data-models` will contain log messages -from the run that produced the file. These are stored in the ASDF portion -of the file and can be inspected by opening the file as a -:ref:`jwst-data-models`. - -The ``cal_logs`` attribute contains log messages as lists of strings -organized by step or pipeline name. For example to see log messages from -:ref:`calwebb_detector1`: - -:: - - import stdatamodels.jwst.datamodels as dm - model = dm.open("jw00001001001_01101_00001_mirimage_cal.fits") - print(model.cal_logs.calwebb_detector1) - -Files processed by a pipeline will contain all logs messages for that -run under the pipeline name (and not contain ``cal_logs`` for individual -steps that were part of the pipeline). - -Log messages that contain sensitive information (user, hostname, paths, -IP addresses) are replaced with empty strings. Please see the console -logs for those messages. diff --git a/docs/jwst/user_documentation/logging_configuration.rst b/docs/jwst/user_documentation/logging.rst similarity index 67% rename from docs/jwst/user_documentation/logging_configuration.rst rename to docs/jwst/user_documentation/logging.rst index c77cd4c76f..b3d1c0a47a 100644 --- a/docs/jwst/user_documentation/logging_configuration.rst +++ b/docs/jwst/user_documentation/logging.rst @@ -1,6 +1,39 @@ -===================== -Logging Configuration -===================== +.. _logging: + +======= +Logging +======= + +.. _cal_logs: + +DataModel cal_logs +================== + +Saved files that contain :ref:`jwst-data-models` will contain log messages +from the run that produced the file. These are stored in the ASDF portion +of the file and can be inspected by opening the file as a +:ref:`jwst-data-models`. + +The ``cal_logs`` attribute contains log messages as lists of strings +organized by step or pipeline name. For example to see log messages from +:ref:`calwebb_detector1`: + +:: + + import stdatamodels.jwst.datamodels as dm + model = dm.open("jw00001001001_01101_00001_mirimage_cal.fits") + print(model.cal_logs.calwebb_detector1) + +Files processed by a pipeline will contain all logs messages for that +run under the pipeline name (and not contain ``cal_logs`` for individual +steps that were part of the pipeline). + +Log messages that contain sensitive information (user, hostname, paths, +IP addresses) are replaced with empty strings. Please see the console +logs for those messages. + +Configuration +============= The name of a file in which to save log information, as well as the desired level of logging messages, can be specified in an optional configuration file.