Redshift / Client / describe_logging_status

describe_logging_status¶

Redshift.Client.describe_logging_status(**kwargs)¶

Describes whether information, such as queries and connection attempts, is being logged for the specified Amazon Redshift cluster.

Request Syntax

response = client.describe_logging_status(
    ClusterIdentifier='string'
)

Parameters:

ClusterIdentifier (string) –

[REQUIRED]

The identifier of the cluster from which to get the logging status.

Example: examplecluster

Return type:

dict

Returns:

Response Syntax

{
    'LoggingEnabled': True|False,
    'BucketName': 'string',
    'S3KeyPrefix': 'string',
    'LastSuccessfulDeliveryTime': datetime(2015, 1, 1),
    'LastFailureTime': datetime(2015, 1, 1),
    'LastFailureMessage': 'string',
    'LogDestinationType': 's3'|'cloudwatch'|'s3table',
    'LogExports': [
        'string',
    ],
    'S3Tables': {
        'S3Tables': [
            'string',
        ],
        'S3TableNamespace': 'string',
        'S3TableGranularity': 'string',
        'EnabledAll': True|False,
        'LastIngestionTimes': {
            'string': 'string'
        }
    }
}

Response Structure

(dict) –

Describes the status of logging for a cluster.
- LoggingEnabled (boolean) –
  
  true if logging is on, false if logging is off.
- BucketName (string) –
  
  The name of the S3 bucket where the log files are stored.
- S3KeyPrefix (string) –
  
  The prefix applied to the log file names.
- LastSuccessfulDeliveryTime (datetime) –
  
  The last time that logs were delivered.
- LastFailureTime (datetime) –
  
  The last time when logs failed to be delivered.
- LastFailureMessage (string) –
  
  The message indicating that logs failed to be delivered.
- LogDestinationType (string) –
  
  The log destination type. An enum with possible values of s3, cloudwatch, and s3table.
- LogExports (list) –
  
  The collection of exported log types. When LogDestinationType is s3 or cloudwatch, possible values are connectionlog, useractivitylog, and userlog. When LogDestinationType is s3table, the values are the names of the system tables being published.
  - (string) –
- S3Tables (dict) –
  
  The status of system table publishing to S3 Tables. This field is populated only when system table publishing is active.
  - S3Tables (list) –
    
    The system tables currently being published.
    - (string) –
  - S3TableNamespace (string) –
    
    The namespace in the S3 table bucket that holds the published tables.
  - S3TableGranularity (string) –
    
    The scope of system table publishing in effect. Possible values are cluster and account.
  - EnabledAll (boolean) –
    
    true if the cluster is enrolled in all current and future system tables rather than an explicit subset.
  - LastIngestionTimes (dict) –
    
    A map whose keys are the names of the published system tables and whose values are the time each table last received data. Use this to judge data freshness.
    - (string) –
      - (string) –

Exceptions

Redshift.Client.exceptions.ClusterNotFoundFault
Redshift.Client.exceptions.UnsupportedOperationFault