The ceilometer.publisher.file Module

class ceilometer.publisher.file.FilePublisher(conf, parsed_url)[source]

Bases: ceilometer.publisher.ConfigPublisherBase

Publisher metering data to file.

The file publisher pushes metering data into a file. The file name and location should be configured in ceilometer pipeline configuration file. If a file name and location is not specified, this File Publisher will not log any meters other than log a warning in Ceilometer log file.

To enable this publisher, add the following section to the /etc/ceilometer/pipeline.yaml file or simply add it to an existing pipeline:

-
    name: meter_file
    interval: 600
    counters:
        - "*"
    transformers:
    publishers:
        - file:///var/test?max_bytes=10000000&backup_count=5

File path is required for this publisher to work properly. If max_bytes or backup_count is missing, FileHandler will be used to save the metering data. If max_bytes and backup_count are present, RotatingFileHandler will be used to save the metering data.

publish_events(events)[source]

Send an event message for publishing

Parameters:events – events from pipeline after transformation
publish_samples(samples)[source]

Send a metering message for publishing

Parameters:samples – Samples from pipeline after transformation