Scroll to navigation

FEDMSG-LOGGER(1) General Commands Manual FEDMSG-LOGGER(1)

NAME

fedmsg-logger - simply emit messages from the command-line to the fedmsg bus

SYNOPSIS

fedmsg-logger [--message LOGGER_MESSAGE] [--json-input] [--topic TOPIC] [--modname MODNAME] [--cert-prefix CERT_PREFIX] [<common fedmsg options>]

fedmsg-logger [-h|--help]

DESCRIPTION

fedmsg-logger is a simple command-line utility to send messages to the fedmsg bus. It is an ephemeral command, that doesn't bind a 0mq endpoint directly. It sends its messages to a fedmsg-relay(1) daemon that binds a persistent endpoint that the outside world can subscribe to. If the fedmsg-relay(1) service is not running at the address specified in the config, then fedmsg-logger will hang until that service becomes available.

If --message is not specified, this command accepts messages from stdin.

OPTIONS

Print an help message and exit
The message to send.
Take each line of input as JSON.
The topic to which the messages are sent. Defaults to log if unset.
The module name to which the messages are sent. Defaults to logger if unset.
Specify a different cert from /etc/pki/fedmsg

COMMON FEDMSG OPTIONS

Number of io threads for 0mq to use
Prefix for the topic of each message sent.
Number of seconds to sleep after initializing.
Config file to use.
Simply print out the configuration and exit. No action taken.
Timeout in seconds for any blocking zmq operations.
Limit on the number of messages in the queue before blocking.
Number of milliseconds to wait before timing out connections.

TOPIC CONSTRUCTION

The full topic to which the messages are sent is constructed from the topic_prefix and environment set in the fedmsg configuration, and the --topic TOPIC and --modname MODNAME options this way:

<topic_prefix>.<environment>.MODNAME.TOPIC

CAVEATS

Note that when using --json-input, you must send valid JSON, including the use of double quotes as opposed to single quotes:

{"a": 1} is valid JSON.
{'a': 1} is invalid JSON.

EXAMPLES

Send a message from standard input in JSON format:

echo '{"a": 1}' | fedmsg-logger --json-input

Send a message to the git.repo.update topic

echo "Hai there." | fedmsg-logger --modname=git --topic=repo.update

Send a simple message:

fedmsg-logger --message="This is a message."

Send a JSON-format message:

fedmsg-logger --message='{"a": 1}' --json-input

SEE ALSO

fedmsg-relay(1), fedmsg-announce(1)

AUTHORS

Wrote the fedmsg software.
Wrote this manpage for the Debian system.

COPYRIGHT

Copyright © 2014 Nicolas Dandrimont

This manual page was written for the Debian system (and may be used by others).

You can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

On Debian systems, a copy of the license can be found in the /usr/share/common-licenses/LGPL-2.1 file.