Awesome
stanza-plugins
stanza-plugins contains plugins for the Stanza Log Agent
Release Process
All plugins in this repository are released together in a single operation.
Maintainers can create a release using the GitHub UI by creating a release that adheres to Golang's semver format. (v1.2.3
)
Development Guidelines
Plugin Parameters
Labels
- Should be written in title case.
Descriptions
- Should be written in complete (or mostly complete) sentences and end in a period.
- Avoid repeating the parameter label in the description. The label will already appear with the description.
- Container name
- BAD: The name of the container
- GOOD: Specify a single name or use * to collect logs from all containers.
- Container name
- Descriptions should offer additional information on proper configuration.
- Listen IP
- BAD: A syslog ip address of the form
<ip>
- GOOD: A network interface for the agent to bind. Typically 0.0.0.0 for most configurations.
- BAD: A syslog ip address of the form
- Listen IP
- No markdown or markup (e.g. HTML).
- Listen IP
- BAD: A syslog ip address of the form
<ip>
- GOOD: A network interface for the agent to bind. Typically 0.0.0.0 for most configurations.
- BAD: A syslog ip address of the form
- Listen IP
- Try to use 180 characters or less.
- Log Format
- BAD: When choosing the 'default' option, the agent will expect and parse logs in a format that matches the default logging configuration. When choosing the 'observIQ' option, the agent will expect and parse logs in an optimized JSON format that adheres to the observIQ specification, requiring an update to the nginx.conf file. See the NGINX source page for more information.
- GOOD: The observIQ setting expects an optimized JSON format and will require changes to the nginx.conf file. See the Nginx Source docs for more info.
- Log Format
- For enum types, do not include the options in the description if it provides no further information.
- Protocol
- BAD: The protocol of received syslog messages (
rfc3164
orrfc5424
) - GOOD: rfc5424 is the newer and more common format for syslog messages.
- BAD: The protocol of received syslog messages (
- Protocol
- Don't add quotes around option names.
- Start At
- BAD: Start reading file from 'beginning' or 'end'
- GOOD: Reading from the end will only ingest new logs added to the end of the file.
- Start At
Community
Stanza is an open source project. If you'd like to contribute, take a look at our contribution guidelines. We look forward to building with you.
Code of Conduct
Stanza follows the CNCF Code of Conduct. Please report violations of the Code of Conduct to any or all maintainers.
Other questions?
Send us an email, or open an issue with your question. We'd love to hear from you!