Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/FantasticFiasco/serilog-sinks-http
A Serilog sink sending log events over HTTP.
https://github.com/FantasticFiasco/serilog-sinks-http
hacktoberfest http serilog sink
Last synced: 4 days ago
JSON representation
A Serilog sink sending log events over HTTP.
- Host: GitHub
- URL: https://github.com/FantasticFiasco/serilog-sinks-http
- Owner: FantasticFiasco
- License: apache-2.0
- Created: 2016-10-31T22:13:36.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2024-05-22T02:09:44.000Z (6 months ago)
- Last Synced: 2024-05-22T03:25:23.224Z (6 months ago)
- Topics: hacktoberfest, http, serilog, sink
- Language: C#
- Homepage:
- Size: 835 KB
- Stars: 165
- Watchers: 7
- Forks: 42
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# Serilog.Sinks.Http - A Serilog sink sending log events over HTTP
[](https://github.com/FantasticFiasco/serilog-sinks-http/actions/workflows/ci-cd.yml)
[](https://codecov.io/gh/FantasticFiasco/serilog-sinks-http)
[](https://www.nuget.org/packages/Serilog.Sinks.Http/)
[](https://semver.org/)
[](https://www.nuget.org/packages/Serilog.Sinks.Http/)
[](https://github.com/serilog/serilog/wiki)
[](https://gitter.im/serilog/serilog)
[](http://stackoverflow.com/questions/tagged/serilog)
**Package** - [Serilog.Sinks.Http](https://www.nuget.org/packages/serilog.sinks.http) | **Platforms** - .NET 4.5/4.6.1, .NET Standard 2.0/2.1
## Table of contents
- [Introduction](#introduction)
- [Super simple to use](#super-simple-to-use)
- [Typical use cases](#typical-use-cases)
- [Send log events from Docker containers](#send-log-events-from-docker-containers)
- [Send log events to Elasticsearch](#send-log-events-to-elasticsearch)
- [Send log events to Logstash](#send-log-events-to-logstash)
- [Sample applications](#sample-applications)
- [Install via NuGet](#install-via-nuget)
- [Contributors](#contributors)
---
## Introduction
This project started out with a wish to send log events to the Elastic Stack. I had prior experience of [Elastic Filebeat](https://www.elastic.co/beats/filebeat) and didn't like it. I thought the value it added was lower than the complexity it introduced.
Knowing that [Serilog.Sinks.Seq](https://github.com/serilog/serilog-sinks-seq) existed, and knowing that the code was of really good quality, I blatantly copied many of the core files into this project and started developing a general HTTP sink.
And here we are today. I hope you'll find the sink useful. If not, don't hesitate to open an issue.
## Super simple to use
In the following example, the sink will POST log events to `http://www.mylogs.com` over HTTP. We configure the sink using **[named arguments](https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/classes-and-structs/named-and-optional-arguments#named-arguments) instead of positional** because historically we've seen that most breaking changes where the result of a new parameter describing a new feature. Using named arguments means that you more often than not can migrate to new major versions without any changes to your code.
```csharp
ILogger log = new LoggerConfiguration()
.MinimumLevel.Verbose()
.WriteTo.Http(requestUri: "https://www.mylogs.com", queueLimitBytes: null)
.CreateLogger();
log.Information("Logging {@Heartbeat} from {Computer}", heartbeat, computer);
```
Used in conjunction with [Serilog.Settings.Configuration](https://github.com/serilog/serilog-settings-configuration) the same sink can be configured in the following way:
```json
{
"Serilog": {
"MinimumLevel": "Verbose",
"WriteTo": [
{
"Name": "Http",
"Args": {
"requestUri": "https://www.mylogs.com",
"queueLimitBytes": null
}
}
]
}
}
```
The sink can also be configured to be durable, i.e. log events are persisted on disk before being sent over the network, thus protected against data loss after a system or process restart. For more information please read the [wiki](https://github.com/FantasticFiasco/serilog-sinks-http/wiki).
The sink is batching multiple log events into a single request, and the following hypothetical payload is sent over the network as JSON.
```json
[
{
"Timestamp": "2016-11-03T00:09:11.4899425+01:00",
"Level": "Information",
"MessageTemplate": "Logging {@Heartbeat} from {Computer}",
"RenderedMessage": "Logging { UserName: \"Mike\", UserDomainName: \"Home\" } from \"Workstation\"",
"Properties": {
"Heartbeat": {
"UserName": "Mike",
"UserDomainName": "Home"
},
"Computer": "Workstation"
}
},
{
"Timestamp": "2016-11-03T00:09:12.4905685+01:00",
"Level": "Information",
"MessageTemplate": "Logging {@Heartbeat} from {Computer}",
"RenderedMessage": "Logging { UserName: \"Mike\", UserDomainName: \"Home\" } from \"Workstation\"",
"Properties": {
"Heartbeat": {
"UserName": "Mike",
"UserDomainName": "Home"
},
"Computer": "Workstation"
}
}
]
```
## Typical use cases
Producing log events is only half the story. Unless you are consuming them in a matter that benefits you in development or production, there is really no need to produce them in the first place.
Integration with [Elastic Stack](https://www.elastic.co/products) (formerly know as ELK, an acronym for Elasticsearch, Logstash and Kibana) is powerful beyond belief, but there are many alternatives to get the log events into Elasticsearch.
### Send log events from Docker containers
A common solution, given your application is running in Docker containers, is to have *stdout* (standard output) and *stderr* (standard error) passed on to the Elastic Stack. There is a multitude of ways to accomplish this, but one using [Logspout](https://github.com/gliderlabs/logspout) is linked in the [Sample applications](#sample-applications) chapter.
### Send log events to Elasticsearch
The log events can be sent directly to Elasticsearch using [Serilog.Sinks.Elasticsearch](https://github.com/serilog/serilog-sinks-elasticsearch). In this case you've solved your problem without using this sink, and all is well in the world.
### Send log events to Logstash
If you would like to send the log events to Logstash for further processing instead of sending them directly to Elasticsearch, this sink in combination with the [Logstash HTTP input plugin](https://www.elastic.co/blog/introducing-logstash-input-http-plugin) is the perfect match for you. It is a much better solution than having to install [Filebeat](https://www.elastic.co/products/beats/filebeat) on all your instances, mainly because it involves fewer moving parts.
## Sample applications
The following sample applications demonstrate the usage of this sink in various contexts:
- [Serilog and the Elastic Stack](https://github.com/FantasticFiasco/serilog-sinks-http-sample-elastic-stack) - Sample application sending log events to Elastic Stack.
- [Serilog and Fluentd](https://github.com/FantasticFiasco/serilog-sinks-http-sample-fluentd) - Sample application sending log events to Fluentd.
- [Serilog.Sinks.Http - Sample in .NET Core](https://github.com/FantasticFiasco/serilog-sinks-http-sample-dotnet-core) - Sample application producing log events in .NET Core. This project also includes a sample log server and controller in .NET Core.
- [Serilog.Sinks.Http - Sample in .NET Framework](https://github.com/FantasticFiasco/serilog-sinks-http-sample-dotnet-framework) - Sample application producing log events in .NET Framework. This project also includes a sample log server and controller in .NET Framework.
The following sample application demonstrate how Serilog events from a Docker container end up in the Elastic Stack using [Logspout](https://github.com/gliderlabs/logspout), without using `Serilog.Sinks.Http`.
- [Serilog, Logspout and the Elastic Stack](https://github.com/FantasticFiasco/serilog-logspout-elastic-stack) - Sample application sending log events from a Docker container using Logspout to Elastic Stack
## Install via NuGet
If you want to include the HTTP sink in your project, you can [install it directly from NuGet](https://www.nuget.org/packages/Serilog.Sinks.Http/).
To install the sink, run the following command in the Package Manager Console:
```
PM> Install-Package Serilog.Sinks.Http
```
## Contributors
The following users have made significant contributions to this project. Thank you so much!
JetBrains
🚇
C. Augusto Proiete
💵 💬 💻 🤔
Louis Haußknecht
💻 🤔 🐛
rob-somerville
💻 🤔 🐛
Kevin Petit
💻 🤔 🐛
aleksaradz
💻 🤔 🐛
michaeltdaniels
🤔
dusse1dorf
🤔
vaibhavepatel
🐛 💻 🤔
KalininAndreyVictorovich
🐛 💻
Sergios
🐛
Anton Smolkov
💻 🐛
Michael J Conrad
📖
Yuriy Sountsov
🤔
Yuriy Millen
💻 🤔
murlidakhare
🐛
julichan
🐛
janichirag11
🐛
PaulP
🐛