whylogs.app.config

Classes/functions for configuring the whylogs app

.. autodata:: ALL_SUPPORTED_FORMATS

ALL_SUPPORTED_FORMATS#

Supported output formats for whylogs writer configuration

WriterConfig Objects#

class WriterConfig()

Config for whylogs writers

See also:

  • :class:WriterConfigSchema
  • :class:whylogs.app.writers.Writer
  • :func:whylogs.app.writers.writer_from_config

Parameters#

type : str Destination for the writer output, e.g. 'local' or 's3' formats : list All output formats. See :data:ALL_SUPPORTED_FORMATS output_path : str Prefix of where to output files. A directory for type = 'local', or key prefix for type = 's3' path_template : str, optional Templatized path output using standard python string templates. Variables are accessed via $identifier or ${identifier}. See :func:whylogs.app.writers.Writer.template_params for a list of available identifers. Default = :data:whylogs.app.writers.DEFAULT_PATH_TEMPLATE filename_template : str, optional Templatized output filename using standardized python string templates. Variables are accessed via $identifier or ${identifier}. See :func:whylogs.app.writers.Writer.template_params for a list of available identifers. Default = :data:whylogs.app.writers.DEFAULT_FILENAME_TEMPLATE

to_yaml#

| to_yaml(stream=None)

Serialize this config to YAML

Parameters#

stream If None (default) return a string, else dump the yaml into this stream.

from_yaml#

| @staticmethod
| from_yaml(stream, **kwargs)

Load config from yaml

Parameters#

stream : str, file-obj String or file-like object to load yaml from

kwargs ignored

Returns#

config : WriterConfig Generated config

SessionConfig Objects#

class SessionConfig()

Config for a whylogs session.

See also :class:SessionConfigSchema

Parameters#

project : str Project associated with this whylogs session pipeline : str Name of the associated data pipeline writers : list A list of WriterConfig objects defining writer outputs verbose : bool, default=False Output verbosity with_rotation_time: str, default = None, to rotate profiles with time, takes values of overall rotation interval, "s" for seconds "m" for minutes "h" for hours "d" for days

cache_size: int default =1, sets how many dataprofiles to cache in logger during rotation

to_yaml#

| to_yaml(stream=None)

Serialize this config to YAML

Parameters#

stream If None (default) return a string, else dump the yaml into this stream.

from_yaml#

| @staticmethod
| from_yaml(stream)

Load config from yaml

Parameters#

stream : str, file-obj String or file-like object to load yaml from

Returns#

config : SessionConfig Generated config

WriterConfigSchema Objects#

class WriterConfigSchema(Schema)

Marshmallow schema for :class:WriterConfig class.

SessionConfigSchema Objects#

class SessionConfigSchema(Schema)

Marshmallow schema for :class:SessionConfig class.

load_config#

load_config(path_to_config: str = None)

Load logging configuration, from disk and from the environment.

Config is loaded by attempting to load files in the following order. The first valid file will be used

  1. Path set in WHYLOGS_CONFIG environment variable
  2. Current directory's .whylogs.yaml file
  3. ~/.whylogs.yaml (home directory)
  4. /opt/whylogs/.whylogs.yaml path

Returns#

config : SessionConfig, None Config for the logger, if a valid config file is found, else returns None.