Like Prometheus, but for logs.

prometheus hacktoberfest grafana cloudnative logging loki

History

Travis Patterson fad028b4c3 Change tests to bump sarama dependency (#8249 )		3 years ago
..
.gitignore	Change tests to bump sarama dependency (#8249 )	3 years ago
.golangci.yml	Change tests to bump sarama dependency (#8249 )	3 years ago
CHANGELOG.md	Change tests to bump sarama dependency (#8249 )	3 years ago
Dockerfile.kafka	Change tests to bump sarama dependency (#8249 )	3 years ago
LICENSE	Promtail Kafka target (#4568 )	4 years ago
Makefile	Change tests to bump sarama dependency (#8249 )	3 years ago
README.md	Change tests to bump sarama dependency (#8249 )	3 years ago
Vagrantfile	Promtail Kafka target (#4568 )	4 years ago
acl_bindings.go	Promtail Kafka target (#4568 )	4 years ago
acl_create_request.go	Promtail Kafka target (#4568 )	4 years ago
acl_create_response.go	Promtail Kafka target (#4568 )	4 years ago
acl_delete_request.go	Promtail Kafka target (#4568 )	4 years ago
acl_delete_response.go	Promtail Kafka target (#4568 )	4 years ago
acl_describe_request.go	Promtail Kafka target (#4568 )	4 years ago
acl_describe_response.go	Promtail Kafka target (#4568 )	4 years ago
acl_filter.go	Promtail Kafka target (#4568 )	4 years ago
acl_types.go	Promtail Kafka target (#4568 )	4 years ago
add_offsets_to_txn_request.go	Promtail Kafka target (#4568 )	4 years ago
add_offsets_to_txn_response.go	Promtail Kafka target (#4568 )	4 years ago
add_partitions_to_txn_request.go	Promtail Kafka target (#4568 )	4 years ago
add_partitions_to_txn_response.go	Promtail Kafka target (#4568 )	4 years ago
admin.go	Change tests to bump sarama dependency (#8249 )	3 years ago
alter_client_quotas_request.go	Promtail Kafka target (#4568 )	4 years ago
alter_client_quotas_response.go	Promtail Kafka target (#4568 )	4 years ago
alter_configs_request.go	Promtail Kafka target (#4568 )	4 years ago
alter_configs_response.go	Promtail Kafka target (#4568 )	4 years ago
alter_partition_reassignments_request.go	Promtail Kafka target (#4568 )	4 years ago
alter_partition_reassignments_response.go	Promtail Kafka target (#4568 )	4 years ago
alter_user_scram_credentials_request.go	Promtail Kafka target (#4568 )	4 years ago
alter_user_scram_credentials_response.go	Promtail Kafka target (#4568 )	4 years ago
api_versions_request.go	Promtail Kafka target (#4568 )	4 years ago
api_versions_response.go	Promtail Kafka target (#4568 )	4 years ago
async_producer.go	Change tests to bump sarama dependency (#8249 )	3 years ago
balance_strategy.go	Change tests to bump sarama dependency (#8249 )	3 years ago
broker.go	Change tests to bump sarama dependency (#8249 )	3 years ago
client.go	Change tests to bump sarama dependency (#8249 )	3 years ago
compress.go	Change tests to bump sarama dependency (#8249 )	3 years ago
config.go	Change tests to bump sarama dependency (#8249 )	3 years ago
config_resource_type.go	Promtail Kafka target (#4568 )	4 years ago
consumer.go	Change tests to bump sarama dependency (#8249 )	3 years ago
consumer_group.go	Change tests to bump sarama dependency (#8249 )	3 years ago
consumer_group_members.go	Change tests to bump sarama dependency (#8249 )	3 years ago
consumer_metadata_request.go	Promtail Kafka target (#4568 )	4 years ago
consumer_metadata_response.go	Promtail Kafka target (#4568 )	4 years ago
control_record.go	Promtail Kafka target (#4568 )	4 years ago
crc32_field.go	Promtail Kafka target (#4568 )	4 years ago
create_partitions_request.go	Promtail Kafka target (#4568 )	4 years ago
create_partitions_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
create_topics_request.go	Promtail Kafka target (#4568 )	4 years ago
create_topics_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
decompress.go	Change tests to bump sarama dependency (#8249 )	3 years ago
delete_groups_request.go	Promtail Kafka target (#4568 )	4 years ago
delete_groups_response.go	Promtail Kafka target (#4568 )	4 years ago
delete_offsets_request.go	Promtail Kafka target (#4568 )	4 years ago
delete_offsets_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
delete_records_request.go	Promtail Kafka target (#4568 )	4 years ago
delete_records_response.go	Promtail Kafka target (#4568 )	4 years ago
delete_topics_request.go	Promtail Kafka target (#4568 )	4 years ago
delete_topics_response.go	Promtail Kafka target (#4568 )	4 years ago
describe_client_quotas_request.go	Promtail Kafka target (#4568 )	4 years ago
describe_client_quotas_response.go	Promtail Kafka target (#4568 )	4 years ago
describe_configs_request.go	Promtail Kafka target (#4568 )	4 years ago
describe_configs_response.go	Promtail Kafka target (#4568 )	4 years ago
describe_groups_request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
describe_groups_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
describe_log_dirs_request.go	Promtail Kafka target (#4568 )	4 years ago
describe_log_dirs_response.go	Promtail Kafka target (#4568 )	4 years ago
describe_user_scram_credentials_request.go	Promtail Kafka target (#4568 )	4 years ago
describe_user_scram_credentials_response.go	Promtail Kafka target (#4568 )	4 years ago
dev.yml	Change tests to bump sarama dependency (#8249 )	3 years ago
docker-compose.yml	Change tests to bump sarama dependency (#8249 )	3 years ago
encoder_decoder.go	Change tests to bump sarama dependency (#8249 )	3 years ago
end_txn_request.go	Promtail Kafka target (#4568 )	4 years ago
end_txn_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
entrypoint.sh	Change tests to bump sarama dependency (#8249 )	3 years ago
errors.go	Change tests to bump sarama dependency (#8249 )	3 years ago
fetch_request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
fetch_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
find_coordinator_request.go	Promtail Kafka target (#4568 )	4 years ago
find_coordinator_response.go	Promtail Kafka target (#4568 )	4 years ago
gssapi_kerberos.go	Promtail Kafka target (#4568 )	4 years ago
heartbeat_request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
heartbeat_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
incremental_alter_configs_request.go	Promtail Kafka target (#4568 )	4 years ago
incremental_alter_configs_response.go	Promtail Kafka target (#4568 )	4 years ago
init_producer_id_request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
init_producer_id_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
interceptors.go	Promtail Kafka target (#4568 )	4 years ago
join_group_request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
join_group_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
kerberos_client.go	Promtail Kafka target (#4568 )	4 years ago
leave_group_request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
leave_group_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
length_field.go	Promtail Kafka target (#4568 )	4 years ago
list_groups_request.go	Promtail Kafka target (#4568 )	4 years ago
list_groups_response.go	Promtail Kafka target (#4568 )	4 years ago
list_partition_reassignments_request.go	Promtail Kafka target (#4568 )	4 years ago
list_partition_reassignments_response.go	Promtail Kafka target (#4568 )	4 years ago
message.go	Change tests to bump sarama dependency (#8249 )	3 years ago
message_set.go	Change tests to bump sarama dependency (#8249 )	3 years ago
metadata_request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
metadata_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
metrics.go	Change tests to bump sarama dependency (#8249 )	3 years ago
mockbroker.go	Change tests to bump sarama dependency (#8249 )	3 years ago
mockkerberos.go	Promtail Kafka target (#4568 )	4 years ago
mockresponses.go	Change tests to bump sarama dependency (#8249 )	3 years ago
offset_commit_request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
offset_commit_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
offset_fetch_request.go	Promtail Kafka target (#4568 )	4 years ago
offset_fetch_response.go	Promtail Kafka target (#4568 )	4 years ago
offset_manager.go	Change tests to bump sarama dependency (#8249 )	3 years ago
offset_request.go	Promtail Kafka target (#4568 )	4 years ago
offset_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
packet_decoder.go	Change tests to bump sarama dependency (#8249 )	3 years ago
packet_encoder.go	Promtail Kafka target (#4568 )	4 years ago
partitioner.go	Promtail Kafka target (#4568 )	4 years ago
prep_encoder.go	Promtail Kafka target (#4568 )	4 years ago
produce_request.go	Promtail Kafka target (#4568 )	4 years ago
produce_response.go	Promtail Kafka target (#4568 )	4 years ago
produce_set.go	Change tests to bump sarama dependency (#8249 )	3 years ago
quota_types.go	Promtail Kafka target (#4568 )	4 years ago
real_decoder.go	Change tests to bump sarama dependency (#8249 )	3 years ago
real_encoder.go	Promtail Kafka target (#4568 )	4 years ago
record.go	Promtail Kafka target (#4568 )	4 years ago
record_batch.go	Change tests to bump sarama dependency (#8249 )	3 years ago
records.go	Change tests to bump sarama dependency (#8249 )	3 years ago
request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
response_header.go	Change tests to bump sarama dependency (#8249 )	3 years ago
sarama.go	Change tests to bump sarama dependency (#8249 )	3 years ago
sasl_authenticate_request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
sasl_authenticate_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
sasl_handshake_request.go	Promtail Kafka target (#4568 )	4 years ago
sasl_handshake_response.go	Promtail Kafka target (#4568 )	4 years ago
scram_formatter.go	Promtail Kafka target (#4568 )	4 years ago
sticky_assignor_user_data.go	Promtail Kafka target (#4568 )	4 years ago
sync_group_request.go	Change tests to bump sarama dependency (#8249 )	3 years ago
sync_group_response.go	Change tests to bump sarama dependency (#8249 )	3 years ago
sync_producer.go	Change tests to bump sarama dependency (#8249 )	3 years ago
timestamp.go	Promtail Kafka target (#4568 )	4 years ago
transaction_manager.go	Change tests to bump sarama dependency (#8249 )	3 years ago
txn_offset_commit_request.go	Promtail Kafka target (#4568 )	4 years ago
txn_offset_commit_response.go	Promtail Kafka target (#4568 )	4 years ago
utils.go	Change tests to bump sarama dependency (#8249 )	3 years ago
version.go	Change tests to bump sarama dependency (#8249 )	3 years ago
zstd.go	Change tests to bump sarama dependency (#8249 )	3 years ago

README.md

sarama

Sarama is an MIT-licensed Go client library for Apache Kafka.

Getting started

API documentation and examples are available via pkg.go.dev.
Mocks for testing are available in the mocks subpackage.
The examples directory contains more elaborate example applications.
The tools directory contains command line tools that can be useful for testing, diagnostics, and instrumentation.

You might also want to look at the Frequently Asked Questions.

Compatibility and API stability

Sarama provides a "2 releases + 2 months" compatibility guarantee: we support the two latest stable releases of Kafka and Go, and we provide a two month grace period for older releases. However, older releases of Kafka are still likely to work.

Sarama follows semantic versioning and provides API stability via the gopkg.in service. You can import a version with a guaranteed stable API via http://gopkg.in/Shopify/sarama.v1. A changelog is available here.

Contributing

Get started by checking our contribution guidelines.
Read the Sarama wiki for more technical and design details.
The Kafka Protocol Specification contains a wealth of useful information.
For more general issues, there is a google group for Kafka client developers.
If you have any questions, just ask!