Skip to content

Latest commit

 

History

History
1689 lines (1350 loc) · 144 KB

CHANGELOG.md

File metadata and controls

1689 lines (1350 loc) · 144 KB

2.0.0 (2020/10/26)

2.0.0 is here!!

We are extremely excited about the new features in 2.0.0, unlocking a whole new world of observability of our logs.

Thanks again for the many incredible contributions and improvements from the wonderful Loki community, we are very excited for the future!

Important Notes

Please Note There are several changes in this release which require your attention!

  • Anyone using a docker image please go read the upgrade guide!! There is one important consideration around a potentially breaking schema change depending on your configuration.
  • MAJOR changes have been made to the boltdb-shipper index, breaking changes are not expected but extra precautions are highly recommended, more details in the upgrade guide.
  • The long deprecated entry_parser config in Promtail has been removed, use pipeline_stages instead.

Check the upgrade guide for detailed information on all these changes.

2.0!!!!

There are too many PR's to list individually for the major improvements which we thought justified a 2.0 but here is the high level:

  • Significant enhancements to the LogQL query language! ** Parse your logs to extract labels at query time. ** Filter on query time extracted labels. ** Format your log lines any way you please! ** Graph the contents of your log lines as metrics, including support for many more of your favorite PromQL functions.
  • Generate prometheus alerts directly from your logs! ** Create alerts using the same prometheus alert rule syntax and let Loki send alerts directly to your Prometheus Alertmanager!
  • boltdb-shipper is now production ready! ** This is it! Now Loki only needs a single object store (S3,GCS,Filesystem...) to store all the data, no more Cassandra, DynamoDB or Bigtable!

We are extremely excited about these new features, expect some talks, webinars, and blogs where we explain all this new functionality in detail.

Notable mention

This is a small change but very helpful!

  • 2737 dlemel8: cmd/loki: add "verify-config" flag

Thank you @dlemel8 for this PR! Now you can start Loki with -verify-config to make sure your config is valid and Loki will exit with a status code 0 if it is!

All Changes

Loki

  • 2804 slim-bean: Loki: log any chunk fetch failure
  • 2803 slim-bean: Update local and docker default config files to use boltdb-shipper with a few other config changes
  • 2796 cyriltovena: Fixes a bug that would add error label incorrectly.
  • 2793 cyriltovena: Improve the way we reverse iterator for backward queries.
  • 2790 sandeepsukhani: Boltdb shipper metrics changes
  • 2788 sandeepsukhani: add a metric in compactor to record timestamp of last successful run
  • 2786 cyriltovena: Logqlv2 pushes groups down to edge
  • 2778 cyriltovena: Logqv2 optimization
  • 2774 cyriltovena: Handle panic in the store goroutine.
  • 2773 cyriltovena: Fixes race conditions in the batch iterator.
  • 2770 sandeepsukhani: Boltdb shipper query performance improvements
  • 2769 cyriltovena: LogQL: Labels and Metrics Extraction
  • 2768 cyriltovena: Fixes all lint errors.
  • 2761 owen-d: Service discovery refactor
  • 2755 owen-d: Revendor Cortex
  • 2752 kavirajk: fix: Remove depricated entry_parser from scrapeconfig
  • 2741 owen-d: better tenant logging in ruler memstore
  • 2737 dlemel8: cmd/loki: add "verify-config" flag
  • 2735 cyriltovena: Fixes the frontend logs to include org_id.
  • 2732 sandeepsukhani: set timestamp in instant query done by canaries
  • 2726 dvrkps: hack: clean getStore
  • 2711 owen-d: removes r/w pools from block/chunk types
  • 2709 cyriltovena: Bypass sharding middleware when a query can't be sharded.
  • 2671 alrs: pkg/querier: fix dropped error
  • 2665 cnbailian: Loki: Querier APIs respond JSON Content-Type
  • 2663 owen-d: improves numeric literal stringer impl
  • 2662 owen-d: exposes rule group validation fn
  • 2661 owen-d: Enable local rules backend & disallow configdb.
  • 2656 sandeepsukhani: run multiple queries per table at once with boltdb-shipper
  • 2655 sandeepsukhani: fix store query bug when running loki in single binary mode with boltdb-shipper
  • 2650 owen-d: Adds prometheus ruler routes
  • 2647 arl: pkg/chunkenc: fix test using string(int) conversion
  • 2645 arl: Tests: fix issue 2356: distributor_test.go fails when the system has no interface name in [eth0, en0, lo0]
  • 2642 sandeepsukhani: fix an issue with building loki
  • 2640 sandeepsukhani: improvements for boltdb-shipper compactor
  • 2637 owen-d: Ruler docs + single binary inclusion
  • 2627 sandeepsukhani: revendor cortex to latest master
  • 2620 alrs: pkg/storage/stores/shipper/uploads: fix test error
  • 2614 cyriltovena: Improve lz4 compression
  • 2613 sandeepsukhani: fix a panic when trying to stop boltdb-shipper multiple times using sync.once
  • 2610 slim-bean: Loki: Fix query-frontend ready handler
  • 2601 sandeepsukhani: rpc for querying ingesters to get chunk ids from its store
  • 2589 owen-d: Ruler/loki rule validator
  • 2582 yeya24: Add _total suffix to ruler counter metrics
  • 2580 owen-d: strict rule unmarshaling
  • 2578 owen-d: exports grouploader
  • 2576 owen-d: Better rule loading
  • 2574 sandeepsukhani: fix closing of compressed file from boltdb-shipper compactor
  • 2572 adityacs: Validate max_query_length in Labels API
  • 2564 owen-d: Error on no schema configs
  • 2559 sandeepsukhani: fix dir setup based on which mode it is running
  • 2558 sandeepsukhani: cleanup boltdb files in queriers during startup/shutdown
  • 2552 owen-d: fixes batch metrics help text & corrects bucketing
  • 2550 sandeepsukhani: fix a flaky test in boltdb shipper
  • 2548 sandeepsukhani: add some metrics for monitoring compactor
  • 2546 sandeepsukhani: register boltdb shipper compactor cli flags
  • 2543 sandeepsukhani: revendor cortex to latest master
  • 2534 owen-d: Consistent chunk metrics
  • 2530 sandeepsukhani: minor fixes and improvements for boltdb shipper
  • 2526 sandeepsukhani: compactor for compacting boltdb files uploaded by shipper
  • 2510 owen-d: adds batch based metrics
  • 2507 sandeepsukhani: compress boltdb files to gzip while uploading from shipper
  • 2458 owen-d: Feature/ruler (take 2)
  • 2487 sandeepsukhani: upload boltdb files from shipper only when they are not expected to be modified or during shutdown

Docs

  • 2797 cyriltovena: Logqlv2 docs
  • 2772 DesistDaydream: reapir Retention Example Configuration
  • 2762 PabloCastellano: fix: typo in upgrade.md
  • 2750 owen-d: fixes path in prom rules api docs
  • 2733 owen-d: Removes wrong capitalizations
  • 2728 vishesh92: Docs: Update docs for redis
  • 2725 dvrkps: fix some misspells
  • 2724 MadhavJivrajani: DOCS: change format of unordered lists in technical docs
  • 2716 huikang: Doc: fixing parameter name in configuration
  • 2705 owen-d: shows cortextool lint command for loki in alerting docs
  • 2702 huikang: Doc: fix broken links in production/README.md
  • 2699 sandangel: docs: use repetitive numbering
  • 2698 bemasher: Doc: Vague link text.
  • 2697 owen-d: updates alerting docs with new cortex tool loki linting support
  • 2692 philnichol: Docs: Corrected incorrect instances of (setup|set up)
  • 2691 UniqueTokens: Update metrics.md
  • 2689 pgassmann: docker plugin documentation update
  • 2686 demon: docs: Fix link to code of conduct
  • 2657 owen-d: fixes ruler docs & includes ruler configs in cmd/configs + docker img
  • 2622 sandeepsukhani: add compactor details and other boltdb-shipper doc improvments
  • 2621 cyriltovena: Fixes links in aws tutorials.
  • 2606 cyriltovena: More template stage examples.
  • 2605 Decad: Update docs to use raw link
  • 2600 slim-bean: Docs: Fix broken links on generated site
  • 2597 nek-00-ken: Fixup: url to access promtail config sample
  • 2595 sh0rez: docs: fix broken links
  • 2594 wardbekker: Update README.md
  • 2592 owen-d: fixes some doc links
  • 2591 woodsaj: Docs: fix links in installation docs
  • 2586 ms42Q: Doc fixes: remove typos and long sentence
  • 2579 oddlittlebird: Update CODEOWNERS
  • 2566 owen-d: Website doc link fixes
  • 2528 owen-d: Update tanka.md with steps for using k8s-alpha lib
  • 2512 palemtnrider: Documentation: Fixes install and getting-started links in the readme
  • 2508 owen-d: memberlist correct yaml path. closes #2499
  • 2506 ferdikurniawan: Docs: fix dead link
  • 2505 sh0rez: doc: close code block
  • 2501 tivvit: fix incorrect upgrade link
  • 2500 oddlittlebird: Docs: Update README.md

Helm

  • 2746 marcosartori: helm/fluentbit K8S-Logging.Exclude & and Mem_Buf_Limit toggle
  • 2742 steven-sheehy: Fix linting errors and use of deprecated repositories
  • 2659 rskrishnar: [Promtail] enables configuring psp in helm chart
  • 2554 alexandre-allard-scality: production/helm: add support for PV selector in Loki statefulset

FluentD

  • 2739 jgehrcke: FluentD loki plugin: add support for bearer_token_file parameter

Fluent Bit

  • 2568 zjj2wry: fluent-bit plugin support TLS

Promtail

  • 2723 carlpett: Promtail: Add counter promtail_batch_retries_total
  • 2717 slim-bean: Promtail: Fix deadlock on tailer shutdown.
  • 2710 slim-bean: Promtail: (and also fluent-bit) change the max batch size to 1MB
  • 2708 Falco20019: Promtail: Fix timestamp parser for short year format
  • 2658 slim-bean: Promtail: do not mark the position if the file is removed
  • 2618 slim-bean: Promtail: Add a stream lagging metric
  • 2615 aminjam: Add fallback_formats for timestamp stage
  • 2603 rfratto: Expose UserAgent and fix User-Agent version source
  • 2575 unguiculus: Promtail: Fix docker-compose.yaml
  • 2571 rsteneteg: Promtail: adding pipeline stage for dropping labels
  • 2570 slim-bean: Promtail: Fix concurrent map iteration when using stdin
  • 2565 carlpett: Add a counter for empty syslog messages
  • 2542 slim-bean: Promtail: implement shutdown for the no-op server
  • 2532 slim-bean: Promtail: Restart the tailer if we fail to read and upate current position

Ksonnet

  • 2719 halcyondude: nit: fix formatting for ksonnet/loki
  • 2677 sandeepsukhani: fix jsonnet for memcached-writes when using boltdb-shipper
  • 2617 periklis: Add config options for loki dashboards
  • 2612 fredr: Dashboard: typo in Loki Operational dashboard
  • 2599 sandeepsukhani: fix closing bracket in dashboards from loki-mixin
  • 2584 sandeepsukhani: Read, Write and operational dashboard improvements
  • 2560 owen-d: Jsonnet/ruler
  • 2547 sandeepsukhani: jsonnet for running loki using boltdb-shipper
  • 2525 Duologic: fix(ksonnet): don't depend on specific k8s version
  • 2521 charandas: fix: broken links in Tanka documentation
  • 2503 owen-d: Ksonnet docs
  • 2494 primeroz: Jsonnet Promtail: Change function for mounting configmap in promtail daemonset

Logstash

  • 2607 adityacs: Logstash cpu usage fix

Build

  • 2602 sandeepsukhani: add support for building querytee
  • 2561 tharun208: Added logcli docker image
  • 2549 simnv: Ignore .exe files build for Windows
  • 2527 owen-d: Update docker-compose.yaml to use 1.6.0

Docker Logging Driver

  • 2459 RaitoBezarius: Docker logging driver: Add a keymod for the extra attributes from the Docker logging driver

Dependencies

  • Go Version: 1.14.2
  • Cortex Version: 85942c5703cf22b64cecfd291e7e7c42d1b8c30c

1.6.1 (2020-08-24)

This is a small release and only contains two fixes for Promtail:

  • 2542 slim-bean: Promtail: implement shutdown for the no-op server
  • 2532 slim-bean: Promtail: Restart the tailer if we fail to read and upate current position

The first only applies if you are running Promtail with both --stdin and --server.disabled=true flags.

The second is a minor rework to how Promtail handles a very specific error when attempting to read the size of a file and failing to do so.

Upgrading Promtail from 1.6.0 to 1.6.1 is only necessary if you have logs full of msg="error getting tail position and/or size", the code changed in this release has been unchanged for a long time and we suspect very few people are seeing this issue.

No changes to any other components (Loki, Logcli, etc) are included in this release.

1.6.0 (2020-08-13)

It's the second thursday of the eighth month of the year which means it's time for another Loki Release!!

Before we highlight important features and changes, congratulations to @adityacs, who is the newest member of the Loki team! Aditya has been regularly contributing to the Loki project for the past year, with each contribution better than the last. Many of the items on the following list were thanks to his hard work. Thank you, Aditya, and welcome to the team!

I think we might have set a new record with 189 PR's in this release!

Important Notes

Please Note There are several changes in this release which might require your attention!

  • The NET_BIND_SERVICE capability was removed from the Loki process in the docker image, it's no longer possible to run Loki with the supplied image on a port less than 1024
  • If you run microservices, there is an important rollout sequence to prevent query errors.
  • Scrape configs have changed for Promtail in both Helm and Ksonnet affecting two labels: instance -> pod and container_name -> container.
  • Almost all of the Loki Canary metrics were renamed.
  • A few command line flags where changed (although they are likely not commonly used)
  • If you use ksonnet and run on GCS and Bigtable you may see an error in your config as a default value was removed.
  • If you are using boltdb-shipper, you will likekly need to add a new schema_config entry.

Check the upgrade guide for detailed information on all these changes.

Notable Features and Fixes

Query language enhancements

  • 2150 introduces bytes_rate, which calculates the per second byte rate of a log stream, and bytes_over_time, which returns the byte size of a log stream.
  • 2182 introduces a long list of comparison operators, which will let you write queries like count_over_time({foo="bar"}[1m]) > 10. Check out the PR for a more detailed description.

Loki performance improvements

  • 2216, 2218, and 2219 all improve how memory is allocated and reused for queries.
  • 2239 is a huge improvement for certain cases in which a query covers a large number of streams that all overlap in time. Overlapping data is now internally cached while Loki works to sort all the streams into the proper time order.
  • 2293 was a big refactor to how Loki internally processes log queries vs. metric queries, creating separate code paths to further optimize metric queries. Metric query performance is now 2 to 10 times faster.

If you are using the query-frontend:

  • 2441 improves how label queries can be split and queried in parallel
  • 2123 allows queries to the series API to be split by time and parallelized; and last but most significant
  • 1927 allows for a much larger range of queries to be sharded and performed in parallel. Query sharding is a topic in itself, but as a rough summary, this type of sharding is not time dependent and leverages how data is already stored by Loki to be able to split queries up into 16 separate pieces to be queried at the same time.

Promtail

  • 2296 allows Promtail to expose the Loki Push API. With this, you can push from any client to Promtail as if it were Loki, and Promtail can then forward those logs to another Promtail or to Loki. There are some good use cases for this with the Loki Docker Logging Driver; if you want an easier way to configure pipelines or expose metrics collection, point your Docker drivers at a Promtail instance.
  • 2282 contains an example Amazon Lambda where you can use a fan-in approach and ingestion timestamping in Promtail to work around out of order issues with multiple Lambdas processing the same log stream. This is one way to get logs from a high-cardinality source without adding a high-cardinality label.
  • 2060 introduces the Replace stage, which lets you find and replace or remove text inside a log line. Combined with 2422 and 2480, you can now find and replace sensitive data in a log line like a password or email address and replace it with ****, or hash the value to prevent readability, while still being able to trace the value through your logs. Last on the list of pipeline additions,
  • 2496 adds a Drop pipeline stage, which lets you drop log lines based on several criteria options including regex matching content, line length, or the age of the log line. The last two are useful to prevent sending to Loki logs that you know would be rejected based on configured limits in the Loki server.

Logstash output plugin

  • 1822 added a Logstash output plugin for Loki. If you have an existing Logstash install, you can now use this plugin to send your logs to Loki to make it easier to try out, or use Loki alongside an existing logging installation.

Loki Canary

  • 2344 improved the canaries capabilities for checking for data integrity, including spot checking for logs over a longer time window and running metric queries to verify count_over_time accuracy.

Logcli

  • 2470 allows you to color code your log lines based on their stream labels for a nice visual indicator of streams.
  • 2497 expands on the series API query to Loki with the--analyze-labels flag, which can show you a detailed breakdown of your label key and value combinations. This is very useful for finding improper label usage in Loki or labels with high cardinality.
  • 2482, in which LogCLI will automatically batch requests to Loki to allow making queries with a --limit= far larger than the server side limit defined in Loki. LogCLI will dispatch the request in a series of queries configured by the --batch= parameter (which defaults to 1000) until the requested limit is reached!

Misc

  • 2453 improves the error messages when a query times out, as Context Deadline Exceeded wasn’t the most intuitive.
  • 2336 provides two new flags that will print the entire Loki config object at startup. Be warned there are a lot of config options, and many won’t apply to your setup (such as storage configs you aren’t using), but this can be a really useful tool when troubleshooting. Sticking with the theme of best for last,
  • 2224 and 2288 improve support for running Loki with a shared Ring using memberlist while not requiring Consul or Etcd. We need to follow up soon with some better documentation or a blog post on this!

Dependencies

  • Go Version: 1.14.2
  • Cortex Version: 7014ff11ed70d9d59ad29d0a95e73999c436c47c

All Changes

Loki

  • 2484 slim-bean: Loki: fix batch iterator error when all chunks overlap and chunk time ranges are greater than query time range
  • 2483 sandeepsukhani: download boltdb files parallelly during reads
  • 2472 owen-d: series endpoint uses normal splits
  • 2466 owen-d: BatchIter edge cases
  • 2463 sandeepsukhani: revendor cortex to latest master
  • 2457 adityacs: Fix panic in cassandra storage while registering metrics
  • 2453 slim-bean: Loki: Improve error messages on query timeout or cancel
  • 2450 adityacs: Fixes panic in runtime_config
  • 2449 jvrplmlmn: Replace usage of sync/atomic with uber-go/atomic
  • 2441 cyriltovena: Split label names queries in the frontend.
  • 2427 owen-d: Revendor cortex
  • 2392 owen-d: avoid mutating config while parsing -config.file
  • 2346 cyriltovena: Fixes LogQL grouping
  • 2336 slim-bean: Loki: add -print-config-stderr flag to dump loki's runtime config to stderr
  • 2330 slim-bean: Loki: Use a new context to update the ring state after a failed chunk transfer
  • 2328 slim-bean: Loki: Transfer one chunk at a time per series during chunk transfers
  • 2327 adityacs: Fix data race in ingester
  • 2323 cyriltovena: Improve object key parsing for boltdb shipper.
  • 2306 cyriltovena: Fixes buffered iterator skipping very long lines.
  • 2302 cyriltovena: Improve entry deduplication.
  • 2294 cyriltovena: Remove NET_BIND_SERVICE capability requirement.
  • 2293 cyriltovena: Improve metric queries by computing samples at the edges.
  • 2288 periklis: Add support for memberlist dns-based discovery
  • 2268 owen-d: lock fix for flaky test
  • 2266 cyriltovena: Update to latest cortex.
  • 2264 adityacs: Fix ingester results for series query
  • 2261 sandeepsukhani: create smaller unique files from boltdb shipper and other code refactorings
  • 2254 slim-bean: Loki: Series API will return all series with no match or empty matcher
  • 2252 owen-d: avoids further time splitting in querysharding mware
  • 2250 slim-bean: Loki: Remove redundant log warning
  • 2249 owen-d: avoids recording stats in the sharded engine
  • 2248 cyriltovena: Add performance profile flags for logcli.
  • 2239 cyriltovena: Cache overlapping blocks
  • 2224 periklis: Replace memberlist service in favor of cortex provided service
  • 2223 adityacs: Add Error method for step evaluators
  • 2219 cyriltovena: Reuse slice for the range vector allocations.
  • 2218 cyriltovena: Reuse buffer for hash computation in the engine.
  • 2216 cyriltovena: Improve point allocations for each steps in the logql engine.
  • 2211 sandeepsukhani: query tee proxy with support for comparison of responses
  • 2206 sandeepsukhani: disable index dedupe when rf > 1 and current or upcoming index type is boltdb-shipper
  • 2204 owen-d: bumps cortex & fixes conflicts
  • 2191 periklis: Add flag to disable tracing activation
  • 2189 owen-d: Fix vector-scalar comparisons
  • 2182 owen-d: Logql comparison ops
  • 2178 cyriltovena: Fixes path prefix in the querier.
  • 2166 sandeepsukhani: enforce requirment for periodic config for index tables to be 24h when using boltdb shipper
  • 2161 cyriltovena: Fix error message for max tail connections.
  • 2156 sandeepsukhani: boltdb shipper download failure handling and some refactorings
  • 2150 cyriltovena: Bytes aggregations
  • 2136 cyriltovena: Fixes Iterator boundaries
  • 2123 adityacs: Fix Series API slowness
  • 1927 owen-d: Feature/querysharding ii
  • 2032 tivvit: Added support for tail to query frontend

Promtail

  • 2496 slim-bean: Promtail: Drop stage
  • 2475 slim-bean: Promtail: force the log level on any Loki Push API target servers to match Promtail's log level.
  • 2474 slim-bean: Promtail: use --client.external-labels for all clients
  • 2471 owen-d: Fix/promtail yaml config
  • 2464 slim-bean: Promtail: Bug: loki push api, clone labels before handling
  • 2438 rfratto: pkg/promtail: propagate a logger rather than using util.Logger globally
  • 2432 pyr0hu: Promtail: Allow empty replace values for replace stage
  • 2422 wardbekker: Template: Added a sha256 template function for obfuscating / anonymize PII data in e.g. the replace stage
  • 2414 rfratto: Add RegisterFlagsWithPrefix to config structs
  • 2386 cyriltovena: Add regex function to promtail template stage.
  • 2345 adityacs: Refactor Promtail target manager code
  • 2301 flixr: Promtail: support unix timestamps with fractional seconds
  • 2296 slim-bean: Promtail: Loki Push API
  • 2282 owen-d: Lambda-Promtail
  • 2242 carlpett: Set user agent on outgoing http requests
  • 2196 cyriltovena: Adds default -config.file for the promtail docker images.
  • 2127 bastjan: Update go-syslog to accept non-UTF8 encoding in syslog message
  • 2111 adityacs: Fix Promtail journal seeking known position
  • 2105 fatpat: promtail: Add Entry variable to template
  • 1118 shuttie: promtail: fix high CPU usage on large kubernetes clusters.
  • 2060 adityacs: Feature: Replace stage in pipeline
  • 2087 adityacs: Set JournalTarget Priority value to keyword

Logcli

  • 2497 slim-bean: logcli: adds --analyize-labels to logcli series command and changes how labels are provided to the command
  • 2482 slim-bean: Logcli: automatically batch requests
  • 2470 adityacs: colored labels output for logcli
  • 2235 pstibrany: logcli: Remove single newline from the raw line before printing.
  • 2126 cyriltovena: Validate local storage config for the logcli
  • 2083 adityacs: Support querying labels on time range in logcli

Docs

  • 2473 owen-d: fixes lambda-promtail relative doc link
  • 2454 oddlittlebird: Create CODEOWNERS
  • 2439 till: Docs: updated "Upgrading" for docker driver
  • 2437 wardbekker: DOCS: clarified globbing behaviour of path of the doublestar library
  • 2431 endu: fix dead link
  • 2425 RichiH: Change conduct contact email address
  • 2420 petuhovskiy: Fix docker driver doc
  • 2418 cyriltovena: Add logstash to clients page with FrontMatter.
  • 2402 cyriltovena: More fixes for the website.
  • 2400 tontongg: Fix URL to LogQL documentation
  • 2398 robbymilo: Docs - update links, readme
  • 2397 coderanger: 📝 Note that entry_parser is deprecated.
  • 2396 dnsmichi: Docs: Fix Fluentd title (visible in menu)
  • 2391 cyriltovena: Update fluentd docs and fixes links for the website.
  • 2390 cyriltovena: Fluent bit docs
  • 2389 cyriltovena: Docker driver doc
  • 2385 abowloflrf: Update logo link in README.md
  • 2378 robbymilo: Sync docs to website
  • 2360 owen-d: Makes timestamp parsing docs clearer
  • 2358 rille111: Documentation: Add example for having separate pvc for loki, using helm
  • 2357 owen-d: Storage backend examples
  • 2338 cyriltovena: Add a complete tutorial on how to ship logs from AWS EKS.
  • 2335 cyriltovena: Improve documentation of the metric stage.
  • 2331 cyriltovena: Add a tutorial to forward AWS ECS logs to Loki.
  • 2321 cyriltovena: Tutorial to run Promtail on AWS EC2
  • 2318 adityacs: Configuration documentation improvements
  • 2317 owen-d: remove DynamoDB chunk store doc
  • 2308 wardbekker: Added a link to the replace parsing stage
  • 2305 rafaelpissolatto: Fix schema_config store value
  • 2285 adityacs: Fix local.md doc
  • 2284 owen-d: Update local.md
  • 2279 Fra-nk: Documentation: Refine LogQL documentation
  • 2273 RichiH: Fix typo
  • 2247 carlpett: docs: Fix missing quotes
  • 2233 vyzigold: docs: Add readmes to individual helm charts
  • 2220 oddlittlebird: Docs: Local install edits
  • 2217 fredr: docs: BoltDB typo
  • 2215 fredr: docs: Correct loki address for docker-compose
  • 2172 cyriltovena: Update old link for pipeline stages.
  • 2163 slim-bean: docs: fix an error in the example log line and byte counter metrics
  • 2160 slim-bean: Fix some errors in the upgrade guide to 1.5.0 and add some missing notes discovered by users.
  • 2152 eamonryan: Fix typo in promtail ClusterRole
  • 2139 adityacs: Fix configuration docs
  • 2137 RichiH: Propose new governance
  • 2136 cyriltovena: Fixes Iterator boundaries
  • 2125 theMercedes: Update logql.md
  • 2112 nileshcs: Documentation: Outdated fluentd image name, UID details, link update
  • 2092 i-takizawa: docs: make visible

Build

  • 2467 slim-bean: Update Loki build image

Ksonnet

  • 2460 Duologic: refactor: use $.core.v1.envVar
  • 2452 slim-bean: ksonnet: Reduce querier parallelism to a more sane default value and remove the default setting for storage_backend
  • 2377 Duologic: refactor: moved jaeger-agent-mixin
  • 2373 slim-bean: Ksonnet: Add a Pod Disruption Budget to Loki Ingesters
  • 2185 cyriltovena: Refactor mixin routes and add series API.
  • 2162 slim-bean: ksonnet: Fix up datasources and variables in Loki Operational
  • 2091 beorn7: Keep scrape config in line with the new Prometheus scrape config

Docker logging driver

  • 2435 cyriltovena: Add more precisions on the docker driver installed on the daemon.
  • 2343 jdfalk: loki-docker-driver: Change "ignoring empty line" to debug logging
  • 2295 cyriltovena: Remove mount in the docker driver.
  • 2199 cyriltovena: Docker driver relabeling
  • 2116 cyriltovena: Allows to change the log driver mode and buffer size.

Logstash output plugin

  • 2415 cyriltovena: Set service values via --set for logstash.
  • 2410 adityacs: logstash code refactor and doc improvements
  • 1822 adityacs: Loki Logstash Plugin

Loki canary

  • 2413 slim-bean: Loki-Canary: Backoff retries on query failures, add histograms for query performance.
  • 2369 slim-bean: Loki Canary: One more round of improvements to query for missing websocket entries up to max-wait
  • 2350 slim-bean: Canary tweaks
  • 2344 slim-bean: Loki-Canary: Add query spot checking and metric count checking
  • 2259 ombre8: Canary: make stream configurable

Fluentd

  • 2407 cyriltovena: bump fluentd version to release a new gem.
  • 2399 tarokkk: fluentd: Make fluentd version requirements permissive
  • 2179 takanabe: Improve fluentd plugin development experience
  • 2171 takanabe: Add server TLS certificate verification

Fluent Bit

  • 2375 cyriltovena: Fixes the fluentbit batchwait backward compatiblity.
  • 2367 dojci: fluent-bit: Add more loki client configuration options
  • 2365 dojci: fluent-bit: Fix fluent-bit exit callback when buffering is enabled
  • 2290 cyriltovena: Fixes the lint issue merged to master.
  • 2286 adityacs: Fix fluent-bit newline and tab characters
  • 2142 dojci: Add FIFO queue persistent buffering for fluent bit output plugin
  • 2089 FrederikNS: Allow configuring more options for output configuration

Helm

  • 2406 steven-sheehy: Helm: Fix regression in chart name
  • 2379 StevenReitsma: production/helm: Add emptyDir volume type to promtail PSP
  • 2366 StevenReitsma: production/helm: Add projected and downwardAPI volume types to PodSecurityPolicy (#2355)
  • 2258 Synehan: helm: add annotations to service monitor
  • 2241 chauffer: Kubernetes manifests: Remove namespace from cluster-wide resources
  • 2238 vhrosales: helm: Add loadBalancerIP option to loki chart
  • 2205 joschi36: BUG: add missing namespace in ingress object
  • 2197 cyriltovena: Render loki datasources even if Grafana is disabled.
  • 2141 cyriltovena: Adds the ability to have a pull secrets for Promtail.
  • 2099 allout58: helm/loki-stack: Support Prometheus on a sub-path in Grafana config
  • 2086 osela: helm/loki-stack: render loki datasource only if grafana is enabled
  • 2091 beorn7: Keep scrape config in line with the new Prometheus scrape config

Build

  • 2371 cyriltovena: Fixes helm publish that needs now to add repo.
  • 2341 slim-bean: Build: Fix CI helm test
  • 2309 cyriltovena: Test again arm32 on internal ci.
  • 2307 cyriltovena: Removes arm32 for now as we're migrating the CI.
  • 2287 wardbekker: Change the Grafana image to latest
  • 2212 roidelapluie: Remove unhelpful/problematic term in circleci.yml

1.5.0 (2020-05-20)

It's been a busy month and a half since 1.4.0 was released, and a lot of new improvements have been added to Loki since!

Be prepared for some configuration changes that may cause some bumps when upgrading, we apologize for this but are always striving to reach the right compromise of code simplicity and user/operating experience.

In this case we opted to keep a simplified configuration inline with Cortex rather than a more complicated and error prone internal config mapping or difficult to implement support for multiple config names for the same feature.

This does result in breaking config changes for some configurations, however, these will fail fast and with the list of diffs from the Cortex project should be quick to fix.

Important Notes

Be prepared for breaking config changes. Loki 1.5.0 vendors cortex v1.0.1-0.20200430170006-3462eb63f324, there were substantial breaking config changes in Cortex 1.0 which standardized config options, and fixed typos.

The Loki docker image user has changed to no longer be root

Check the upgrade guide for more detailed information on these changes.

Notable Features and Fixes

There are quite a few we want to mention listed in order they were merged (mostly)

  • 1837 sandeepsukhani: flush boltdb to object store

This is perhaps the most exciting feature of 1.5.0, the first steps in removing a dependency on a separate index store! This feature is still very new and experimental, however, we want this to be the future for Loki. Only requiring just an object store.

If you want to test this new feature, and help us find any bugs, check out the docs to learn more and get started.

  • 2073 slim-bean: Loki: Allow configuring query_store_max_look_back_period when running a filesystem store and boltdb-shipper

This is even more experimental than the previous feature mentioned however also pretty exciting for Loki users who use the filesystem storage. We can leverage changes made in 1837 to now allow Loki to run in a clustered mode with individual filesystem stores!

Please check out the last section in the filesystem docs for more details on how this works and how to use it!

  • 2095 cyriltovena: Adds backtick for the quoted string token lexer.

This will come as a big win to anyone who is writing complicated reqular expressions in either their Label matchers or Filter Expressions. Starting now you can use the backtick to encapsulate your regex and not have to do any escaping of special characters!!

Examples:

{name="cassandra"} |~ `error=\w+`
{name!~`mysql-\d+`}
  • 2055 aknuds1: Chore: Fix spelling of per second in code

This is technically a breaking change for anyone who wrote code to processes the new statistics output in the query result added in 1.4.0, we apologize to anyone in this situation but if we don't fix this kind of error now it will be there forever. And at the same time we didn't feel it was appropriate to make any major api revision changes for such a new feature and simple change. We are always trying to use our best judgement in cases like this.

  • 2031 cyriltovena: Improve protobuf serialization

Thanks @cyriltovena for another big performance improvement in Loki, this time around protbuf's!

  • 2021 slim-bean: Loki: refactor validation and improve error messages
  • 2012 slim-bean: Loki: Improve logging and add metrics to streams dropped by stream limit

These two changes standardize the metrics used to report when a tenant hits a limit, now all discarded samples should be reported under loki_discarded_samples_total and you no longer need to also reference cortex_discarded_samples_total. Additionally error messages were improved to help clients take better action when hitting limits.

  • 1970 cyriltovena: Allow to aggregate binary operations.

Another nice improvement to the query language which allows queries like this to work now:

sum by (job) (count_over_time({namespace="tns"}[5m] |= "level=error") / count_over_time({namespace="tns"}[5m]))
  • 1713 adityacs: Log error message for invalid checksum

In the event something went wrong with a stored chunk, rather than fail the query we ignore the chunk and return the rest.

  • 2066 slim-bean: Promtail: metrics stage can also count line bytes

This is a nice extension to a previous feature which let you add a metric to count log lines per stream, you can now count log bytes per stream.

Check out this example to configure this in your promtail pipelines.

  • 1935 cyriltovena: Support stdin target via flag instead of automatic detection.

Third times a charm! With 1.4.0 we allowed sending logs directly to promtail via stdin, with 1.4.1 we released a patch for this feature which wasn't detecting stdin correctly on some operating systems. Unfortunately after a few more bug reports it seems this change caused some more undesired side effects so we decided to not try to autodetect stdin at all, instead now you must pass the --stdin flag if you want Promtail to listen for logs on stdin.

  • 2076 cyriltovena: Allows to pass inlined pipeline stages to the docker driver.
  • 1906 cyriltovena: Add no-file and keep-file log option for docker driver.

The docker logging driver received a couple very nice updates, it's always been challenging to configure pipeline stages for the docker driver, with the first PR there are now a few easier ways to do this! In the second PR we added config options to control keeping any log files on the host when using the docker logging driver, allowing you to run with no disk access if you would like, as well as allowing you to control keeping log files available after container restarts.

** 1864 cyriltovena: Sign helm package with GPG.

We now GPG sign helm packages!

All Changes

Loki

  • 2097 owen-d: simplifies/updates some of our configuration examples
  • 2095 cyriltovena: Adds backtick for the quoted string token lexer.
  • 2093 cyriltovena: Fixes unit in stats request log.
  • 2088 slim-bean: Loki: allow no encoding/compression on chunks
  • 2078 owen-d: removes yolostring
  • 2073 slim-bean: Loki: Allow configuring query_store_max_look_back_period when running a filesystem store and boltdb-shipper
  • 2064 cyriltovena: Reverse entry iterator pool
  • 2059 cyriltovena: Recover from panic in http and grpc handlers.
  • 2058 cyriltovena: Fix a bug in range vector skipping data.
  • 2055 aknuds1: Chore: Fix spelling of per second in code
  • 2046 gouthamve: Fix bug in logql parsing that leads to crash.
  • 2050 aknuds1: Chore: Correct typo "per seconds"
  • 2034 sandeepsukhani: some metrics for measuring performance and failures in boltdb shipper
  • 2031 cyriltovena: Improve protobuf serialization
  • 2030 adityacs: Update loki to cortex master
  • 2023 cyriltovena: Support post requests in the frontend queryrange handler.
  • 2021 slim-bean: Loki: refactor validation and improve error messages
  • 2019 slim-bean: make loki_ingester_memory_streams Gauge per tenant.
  • 2012 slim-bean: Loki: Improve logging and add metrics to streams dropped by stream limit
  • 2010 cyriltovena: Update lz4 library to latest to ensure deterministic output.
  • 2001 sandeepsukhani: table client for boltdb shipper to enforce retention
  • 1995 sandeepsukhani: make boltdb shipper singleton and some other minor refactoring
  • 1987 slim-bean: Loki: Add a missing method to facade which is called by the metrics storage client in cortex
  • 1982 cyriltovena: Update cortex to latest.
  • 1977 cyriltovena: Ensure trace propagation in our logs.
  • 1976 slim-bean: incorporate some better defaults into table-manager configs
  • 1975 slim-bean: Update cortex vendoring to latest master
  • 1970 cyriltovena: Allow to aggregate binary operations.
  • 1965 slim-bean: Loki: Adds an interval paramater to query_range queries allowing a sampling of events to be returned based on the provided interval
  • 1964 owen-d: chunk bounds metric now records 8h range in 1h increments
  • 1963 cyriltovena: Improve the local config to work locally and inside docker.
  • 1961 jpmcb: [Bug] Workaround for broken etcd gomod import
  • 1958 owen-d: chunk lifespan histogram
  • 1956 sandeepsukhani: update cortex to latest master
  • 1953 jpmcb: Go mod: explicit golang.org/x/net replace
  • 1950 cyriltovena: Fixes case handling in regex simplification.
  • 1949 SerialVelocity: [Loki]: Cleanup dockerfile
  • 1946 slim-bean: Loki Update the cut block size counter when creating a memchunk from byte slice
  • 1939 owen-d: adds config validation, similar to cortex
  • 1916 cyriltovena: Add cap_net_bind_service linux capabilities to Loki.
  • 1914 owen-d: only fetches one chunk per series in /series
  • 1875 owen-d: support match[] encoding
  • 1869 pstibrany: Update Cortex to latest master
  • 1846 owen-d: Sharding optimizations I: AST mapping
  • 1838 cyriltovena: Move default port for Loki to 3100 everywhere.
  • 1837 sandeepsukhani: flush boltdb to object store
  • 1834 Mario-Hofstaetter: Loki/Change local storage directory to /loki/ and fix permissions (#1833)
  • 1819 cyriltovena: Adds a counter for total flushed chunks per reason.
  • 1816 sdojjy: loki can not be started with loki-local-config.yaml
  • 1810 cyriltovena: Optimize empty filter queries.
  • 1809 cyriltovena: Test stats memchunk
  • 1804 pstibrany: Convert Loki modules to services
  • 1799 pstibrany: loki: update Cortex to master
  • 1798 adityacs: Support configurable maximum of the limits parameter
  • 1713 adityacs: Log error message for invalid checksum
  • 1706 cyriltovena: Non-root user docker image for Loki.

Logcli

  • 2027 pstibrany: logcli: Query needs to be stored into url.RawQuery, and not url.Path
  • 2000 cyriltovena: Improve URL building in the logcli to strip trailing /.
  • 1922 bavarianbidi: logcli: org-id/tls-skip-verify set via env var
  • 1861 yeya24: Support series API in logcli
  • 1850 chrischdi: BugFix: Fix logcli client to use OrgID in LiveTail
  • 1814 cyriltovena: Logcli remote storage.
  • 1712 rfratto: clarify logcli commands and output

Promtail

  • 2069 slim-bean: Promtail: log at debug level when nothing matches the specified path for a file target
  • 2066 slim-bean: Promtail: metrics stage can also count line bytes
  • 2049 adityacs: Fix promtail client default values
  • 2075 cyriltovena: Fixes a panic in dry-run when using external labels.
  • 2026 adityacs: Targets not required in promtail config
  • 2004 cyriltovena: Adds config to disable HTTP and GRPC server in Promtail.
  • 1935 cyriltovena: Support stdin target via flag instead of automatic detection.
  • 1920 alexanderGalushka: feat: tms readiness check bypass implementation
  • 1894 cyriltovena: Fixes possible panic in json pipeline stage.
  • 1865 adityacs: Fix flaky promtail test
  • 1815 adityacs: Log error message when source does not exist in extracted values
  • 1627 rfratto: Proposal: Promtail Push API

Docker Driver

  • 2076 cyriltovena: Allows to pass inlined pipeline stages to the docker driver.
  • 2054 bkmit: Docker driver: Allow to provision external pipeline files to plugin
  • 1906 cyriltovena: Add no-file and keep-file log option for docker driver.
  • 1903 cyriltovena: Log docker driver config map.

Fluentd

  • 2074 osela: fluentd plugin: support placeholders in tenant field
  • 2006 Skeen: fluent-plugin-loki: Restructuring and CI
  • 1909 jgehrcke: fluentd loki plugin README: add note about labels
  • 1853 wardbekker: bump gem version
  • 1811 JamesJJ: Error handling: Show data stream at "debug" level, not "warn"

Fluent Bit

  • 2040 avii-ridge: Add extraOutputs variable to support multiple outputs for fluent-bit
  • 1915 DirtyCajunRice: Fix fluent-bit metrics
  • 1890 dottedmag: fluentbit: JSON encoding: avoid base64 encoding of []byte inside other slices
  • 1791 cyriltovena: Improve fluentbit logfmt.

Ksonnet

  • 1980 cyriltovena: Log slow query from the frontend by default in ksonnet.
Mixins
  • 2080 beorn7: mixin: Accept suffixes to pod name in instance labels
  • 2044 slim-bean: Dashboards: fixes the cpu usage graphs
  • 2043 joe-elliott: Swapped to container restarts over terminated reasons
  • 2041 slim-bean: Dashboard: Loki Operational improvements
  • 1934 tomwilkie: Put loki-mixin and promtail-mixin dashboards in a folder.
  • 1913 tomwilkie: s/dashboards/grafanaDashboards.

Helm

  • 2038 oke-py: Docs: update Loki Helm Chart document to support Helm 3
  • 2015 etashsingh: Change image tag from 1.4.1 to 1.4.0 in Helm chart
  • 1981 sshah90: added extraCommandlineArgs in values file
  • 1967 rdxmb: helm chart: add missing line feed
  • 1898 stefanandres: [helm loki/promtail] make UpdateStrategy configurable
  • 1871 stefanandres: [helm loki/promtail] Add systemd-journald example with extraMount, extraVolumeMount
  • 1864 cyriltovena: Sign helm package with GPG.
  • 1825 polar3130: Helm/loki-stack: refresh default grafana.image.tag to 6.7.0
  • 1817 bclermont: Helm chart: Prevent prometheus to scrape both services

Loki Canary

  • 1891 joe-elliott: Addition of a /suspend endpoint to Loki Canary

Docs

  • 2056 cyriltovena: Update api.md
  • 2014 jsoref: Spelling
  • 1999 oddlittlebird: Docs: Added labels content
  • 1974 rfratto: fix stores for chunk and index in documentation for period_config
  • 1966 oddlittlebird: Docs: Update docker.md
  • 1951 cstyan: Move build from source instructions to root readme.
  • 1945 FlorianLudwig: docs: version pin the docker image in docker-compose
  • 1925 wardbekker: Clarified that the api push path needs to be specified.
  • 1905 sshah90: updating typo for end time parameter in api docs
  • 1888 slim-bean: docs: cleaning up the comments for the cache_config, default_validity option
  • 1887 slim-bean: docs: Adding a config change in release 1.4 upgrade doc, updating readme with new doc links
  • 1881 cyriltovena: Add precision about the range notation for LogQL.
  • 1879 slim-bean: docs: update promtail docs for backoff
  • 1873 owen-d: documents frontend worker
  • 1870 ushuz: Docs: Keep plugin install command example in one line
  • 1856 slim-bean: docs: tweak the doc section of the readme a little
  • 1852 slim-bean: docs: clean up schema recommendations
  • 1843 vishesh92: Docs: Update configuration docs for redis

Build

  • 2042 rfratto: Fix drone
  • 2009 cyriltovena: Adds :delegated flags to speed up build experience on MacOS.
  • 1942 owen-d: delete tag script filters by prefix instead of substring
  • 1918 slim-bean: build: This Dockerfile is a remnant from a long time ago, not needed.
  • 1911 slim-bean: build: push images for k branches
  • 1849 cyriltovena: Pin helm version in circle-ci helm testing workflow.

1.4.1 (2020-04-06)

We realized after the release last week that piping data into promtail was not working on Linux or Windows, this should fix this issue for both platforms:

  • 1893 cyriltovena: Removes file size check for pipe, not provided by linux.

Also thanks to @dottedmag for providing this fix for Fluent Bit!

  • 1890 dottedmag: fluentbit: JSON encoding: avoid base64 encoding of []byte inside other slices

1.4.0 (2020-04-01)

Over 130 PR's merged for this release, from 40 different contributors!! We continue to be humbled and thankful for the growing community of contributors and users of Loki. Thank you all so much.

Important Notes

Really, this is important

Before we get into new features, version 1.4.0 brings with it the first (that we are aware of) upgrade dependency.

We have created a dedicated page for upgrading Loki in the operations section of the docs

The docker image tag naming was changed, the starting in 1.4.0 docker images no longer have the v prefix: grafana/loki:1.4.0

Also you should be aware we are now pruning old master-xxxxx docker images from docker hub, currently anything older than 90 days is removed. We will never remove released versions of Loki

Notable Features

  • 1661 cyriltovena: Frontend & Querier query statistics instrumentation.

The API now returns a plethora of stats into the work Loki performed to execute your query, eventually this will be displayed in some form in Grafana to help users better understand how "expensive" their queries are. Our goal here initially was to better instrument the recent work done in v1.3.0 on query parallelization and to better understand the performance of each part of Loki. In the future we are looking at additional ideas to provide feedback to users to tailor their queries for better performance.

  • 1652 cyriltovena: --dry-run Promtail.
  • 1649 cyriltovena: Pipe data to Promtail

This is a long overdue addition to Promtail which can help setup and debug pipelines, with these new features you can do this to feed a single log line into Promtail:

echo -n 'level=debug msg="test log (200)"' | cmd/promtail/promtail -config.file=cmd/promtail/promtail-local-config.yaml --dry-run -log.level=debug 2>&1 | sed 's/^.*stage/stage/g'

-log.level=debug 2>&1 | sed 's/^.*stage/stage/g are added to enable debug output, direct the output to stdout, and a sed filter to remove some noise from the log lines.

The stdin functionality also works without --dry-run allowing you to feed any logs into Promtail via stdin and send them to Loki

  • 1677 owen-d: Literal Expressions in LogQL
  • 1662 owen-d: Binary operators in LogQL

These two extensions to LogQL now let you execute queries like this:

* `sum(rate({app="foo"}[5m])) * 2` 
* `sum(rate({app="foo"}[5m]))/1e6` 
  • 1678 slim-bean: promtail: metrics pipeline count all log lines

Now you can get per-stream line counts as a metric from promtail, useful for seeing which applications log the most

- metrics:
    line_count_total:
      config:
        action: inc
        match_all: true
      description: A running counter of all lines with their corresponding
        labels
      type: Counter
  • 1558 owen-d: ingester.max-chunk-age
  • 1572 owen-d: Feature/query ingesters within

These two configs let you set the max time a chunk can stay in memory in Loki, this is useful to keep memory usage down as well as limit potential loss of data if ingesters crash. Combine this with the query_ingesters_within config and you can have your queriers skip asking the ingesters for data which you know won't still be in memory (older than max_chunk_age).

NOTE Do not set the max_chunk_age too small, the default of 1h is probably a good point for most people. Loki does not perform well when you flush many small chunks (such as when your logs have too much cardinality), setting this lower than 1h risks flushing too many small chunks.

  • 1581 slim-bean: Add sleep to canary reconnect on error

This isn't a feature but it's an important fix, this is the second time our canaries have tried to DDOS our Loki clusters so you should update to prevent them from trying to attack you. Aggressive little things these canaries...

  • 1840 slim-bean: promtail: Retry 429 rate limit errors from Loki, increase default retry limits
  • 1845 wardbekker: throw exceptions on HTTPTooManyRequests and HTTPServerError so Fluentd will retry

These two PR's change how 429 HTTP Response codes are handled (Rate Limiting), previously these responses were dropped, now they will be retried for these clients

* Promtail
* Docker logging driver
* Fluent Bit
* Fluentd

This pushes the failure to send logs to two places. First is the retry limits. The defaults in promtail (and thus also the Docker logging driver and Fluent Bit, which share the same underlying code) will retry 429s (and 500s) on an exponential backoff for up to about 8.5 mins on the default configurations. (This can be changed; see the config docs for more info.)

The second place would be the log file itself. At some point, most log files roll based on size or time. Promtail makes an attempt to read a rolled log file but will only try once. If you are very sensitive to lost logs, give yourself really big log files with size-based rolling rules and increase those retry timeouts. This should protect you from Loki server outages or network issues.

All Changes

There are many other important fixes and improvements to Loki, way too many to call out in individual detail, so take a look!

Loki

  • 1810 cyriltovena: Optimize empty filter queries.
  • 1809 cyriltovena: Test stats memchunk
  • 1807 pracucci: Enable global limits by default in production mixin
  • 1802 cyriltovena: Add a test for duplicates count in the heap iterator and fixes it.
  • 1799 pstibrany: loki: update Cortex to master
  • 1797 cyriltovena: Use ingester client GRPC call options from config.
  • 1794 pstibrany: loki: Convert module names to string
  • 1793 johncming: pkg/chunkenc: fix leak of pool.
  • 1789 adityacs: Fix loki exit on jaeger agent not being present
  • 1787 cyriltovena: Regexp simplification
  • 1785 pstibrany: Update Cortex to master
  • 1758 cyriltovena: Query range should not support date where start == end.
  • 1750 talham7391: Clearer error response from push endpoint when labels are malformed
  • 1746 cyriltovena: Update cortex vendoring to include frontend status code improvement.
  • 1745 cyriltovena: Refactor querier http error handling.
  • 1736 adityacs: Add /ready endpoint to table-manager
  • 1733 cyriltovena: This logs queries with latency tag when recording stats.
  • 1730 adityacs: Fix nil pointer dereference in ingester client
  • 1719 cyriltovena: Expose QueryType function.
  • 1718 cyriltovena: Better logql metric status code.
  • 1708 cyriltovena: Increase discarded samples when line is too long.
  • 1704 owen-d: api support for scalars
  • 1686 owen-d: max line lengths (component + tenant overrides)
  • 1684 cyriltovena: Ensure status codes are set correctly in the frontend.
  • 1677 owen-d: Literal Expressions in LogQL
  • 1662 owen-d: Binary operators in LogQL
  • 1661 cyriltovena: Frontend & Querier query statistics instrumentation.
  • 1651 owen-d: removes duplicate logRangeExprExt grammar
  • 1636 cyriltovena: Fixes stats summary computation.
  • 1630 owen-d: adds stringer methods for all ast expr types
  • 1626 owen-d: compiler guarantees for logql exprs
  • 1616 owen-d: cache key cant be reused when an interval changes
  • 1615 cyriltovena: Add statistics to query_range and instant_query API.
  • 1612 owen-d: bumps cortex to 0.6.1 master
  • 1605 owen-d: Decouple logql engine/AST from execution context
  • 1582 slim-bean: Change new stats names
  • 1579 rfratto: Disable transfers in loki-local-config.yaml
  • 1572 owen-d: Feature/query ingesters within
  • 1677 owen-d: Introduces numeric literals in LogQL
  • 1569 owen-d: refactors splitby to not require buffered channels
  • 1567 owen-d: adds span metadata for split queries
  • 1565 owen-d: Feature/per tenant splitby
  • 1562 sandeepsukhani: limit for concurrent tail requests
  • 1558 owen-d: ingester.max-chunk-age
  • 1484 pstibrany: loki: use new runtimeconfig package from Cortex

Promtail

  • 1840 slim-bean: promtail: Retry 429 rate limit errors from Loki, increase default retry limits
  • 1775 slim-bean: promtail: remove the read lines counter when the log file stops being tailed
  • 1770 adityacs: Fix single job with multiple service discovery elements
  • 1765 adityacs: Fix error in templating when extracted key has nil value
  • 1743 dtennander: Promtail: Ignore dropped entries in subsequent metric-stages in pipelines.
  • 1687 adityacs: Fix panic in labels debug message
  • 1683 slim-bean: promtail: auto-prune stale metrics
  • 1678 slim-bean: promtail: metrics pipeline count all log lines
  • 1666 adityacs: Support entire extracted value map in template pipeline stage
  • 1664 adityacs: Support custom prefix name in metrics stage
  • 1660 rfratto: pkg/promtail/positions: handle empty positions file
  • 1652 cyriltovena: --dry-run Promtail.
  • 1649 cyriltovena: Pipe data to Promtail
  • 1602 slim-bean: Improve promtail configuration docs

Helm

  • 1731 billimek: [promtail helm chart] - Expand promtail syslog svc to support values
  • 1688 fredgate: Loki stack helm chart can deploy datasources without Grafana
  • 1632 lukipro: Added support for imagePullSecrets in Loki Helm chart
  • 1620 rsteneteg: [promtail helm chart] option to set fs.inotify.max_user_instances with init container
  • 1617 billimek: [promtail helm chart] Enable support for syslog service
  • 1590 polar3130: Helm/loki-stack: refresh default grafana.image.tag to 6.6.0
  • 1587 polar3130: Helm/loki-stack: add template for the service name to connect to loki
  • 1585 monotek: [loki helm chart] added ingress
  • 1553 got-root: helm: Allow setting 'loadBalancerSourceRanges' for the loki service
  • 1529 tourea: Promtail Helm Chart: Add support for passing environment variables

Jsonnet

  • 1776 Eraac: fix typo: Not a binary operator: =
  • 1767 joe-elliott: Dashboard Cleanup
  • 1766 joe-elliott: Move dashboards out into their own json files
  • 1757 slim-bean: promtail-mixin: Allow choosing promtail name
  • 1756 sh0rez: fix(ksonnet): named parameters for containerPort
  • 1749 slim-bean: Increasing the threshold for a file lag and reducing the severity to warning
  • 1748 slim-bean: jsonnet: Breakout promtail mixin.
  • 1739 cyriltovena: Fixes frontend args in libsonnet.
  • 1735 cyriltovena: Allow to configure global limits via the jsonnet deployment.
  • 1705 cyriltovena: Add overrides file for our jsonnet library.
  • 1699 pracucci: Increased production distributors memory request and limit
  • 1689 shokada: Add headers for WebSocket
  • 1665 cyriltovena: Query frontend service should be headless.
  • 1613 cyriltovena: Fixes config change in the result cache

Fluent Bit

  • 1791 cyriltovena: Improve fluentbit logfmt.
  • 1717 adityacs: Fluent-bit: Fix panic error when AutoKubernetesLabels is true

Fluentd

  • 1811 JamesJJ: Error handling: Show data stream at "debug" level, not "warn"
  • 1728 irake99: docs: fix outdated link to fluentd
  • 1703 Skeen: fluent-plugin-grafana-loki: Update fluentd base image to current images (edge)
  • 1656 takanabe: Convert second(Integer class) to nanosecond precision
  • 1646 takanabe: Fix rubocop violation for fluentd/fluent-plugin-loki
  • 1603 tarokkk: fluentd-plugin: add URI validation

Docs

  • 1781 candlerb: Docs: Recommended schema is now v11
  • 1771 rfratto: change slack url to slack.grafana.com and use https
  • 1738 jgehrcke: docs: observability.md: clarify lines vs. entries
  • 1707 dangoodman: Fix regex in pipeline-example.yml
  • 1697 oke-py: fix promtail/templates/NOTES.txt to show correctly port-forward command
  • 1675 owen-d: maintainer links & usernames
  • 1673 cyriltovena: Add Owen to the maintainer team.
  • 1671 shokada: Update tanka.md so that promtail.yml is the correct format
  • 1648 ShotaKitazawa: loki-canary: fix indent of DaemonSet manifest written in .md file
  • 1642 slim-bean: Improve systemd field docs
  • 1641 pastatopf: Correct syntax of rate example
  • 1634 takanabe: Unite docs for fluentd plugin
  • 1619 shaikatz: PeriodConfig documentation fix dynamodb -> aws-dynamo
  • 1611 owen-d: loki frontend docs additions
  • 1609 Lusitaniae: Fix wget syntax in documentation
  • 1608 PabloCastellano: Documentation: Recommend using the latest schema version (v11)
  • 1601 rfratto: Clarify regex escaping rules
  • 1598 cyriltovena: Update tanka.md doc.
  • 1586 MrSaints: Fix typo in changelog for 1.3.0
  • 1504 hsraju: Updated configuration.md

Logcli

  • 1808 slim-bean: logcli: log the full stats and send to stderr instead of stdout
  • 1682 adityacs: BugFix: Fix logcli --quiet parameter parsing issue
  • 1644 cyriltovena: This improves the log output for statistics in the logcli.
  • 1638 owen-d: adds query stats and org id options in logcli
  • 1573 cyriltovena: Improve logql query statistics collection.

Loki Canary

  • 1653 slim-bean: Canary needs its logo
  • 1581 slim-bean: Add sleep to canary reconnect on error

Build

  • 1780 slim-bean: build: Update the CD deploy task name
  • 1762 dgzlopes: Bump testify to 1.5.1
  • 1742 slim-bean: build: fix deploy on tagged build
  • 1741 slim-bean: add darwin and freebsd binaries to release output
  • 1740 rfratto: Fix 32-bit Promtail ARM docker builds from Drone
  • 1710 adityacs: Add goimport local-prefixes configuration to .golangci.yml
  • 1647 mattmendick: Attempting to add informational only feedback for codecov
  • 1640 rfratto: ci: print error messages when an API request fails
  • 1639 rfratto: ci: prune docker tags prefixed with "master-" older than 90 days
  • 1637 rfratto: ci: pin plugins/manifest image tag
  • 1633 rfratto: ci: make manifest publishing run in serial
  • 1629 slim-bean: Ignore markdown files in codecoverage
  • 1628 rfratto: Exempt proposals from stale bot
  • 1614 mattmendick: Codecov: Update config to add informational flag
  • 1600 mattmendick: Codecov circleci test [WIP]

Tooling

  • 1577 pstibrany: Move chunks-inspect tool to Loki repo

1.3.0 (2020-01-16)

What's New??

With 1.3.0 we are excited to announce several improvements focusing on performance!

First and most significant is the Query Frontend:

  • 1442 cyriltovena: Loki Query Frontend

The query frontend allows for sharding queries by time and dispatching them in parallel to multiple queriers, giving true horizontal scaling ability for queries. Take a look at the jsonnet changes to see how we are deploying this in our production setup. Keep an eye out for a blog post with more information on how the frontend works and more information on this exciting new feature.

In our quest to improve query performance, we discovered that gzip, while good for compression ratio, is not the best for speed. So we introduced the ability to select from several different compression algorithms:

  • 1411 cyriltovena: Adds configurable compression algorithms for chunks

We are currently testing out LZ4 and snappy, LZ4 seemed like a good fit however we found that it didn't always compress the same data to the same output which was causing some troubles for another important improvement:

  • 1438 pstibrany: pkg/ingester: added sync period flags

Extending on the work done by @bboreham on Cortex, @pstibrany added a few new flags and code to synchronize chunks between ingesters, which reduces the number of chunks persisted to object stores and therefore also reduces the number of chunks loaded on queries and the amount of de-duplication work which needs to be done.

As mentioned above, LZ4 was in some cases compressing the same data with a different result which was interfering with this change, we are still investigating the cause of this issue (It may be in how we implemented something, or may be in the compression code itself). For now we have switched to snappy which has seen a reduction in data written to the object store from almost 3x the source data (with a replication factor of 3) to about 1.5x, saving a lot of duplicated log storage!

Another valuable change related to chunks:

  • 1406 slim-bean: allow configuring a target chunk size in compressed bytes

With this change you can set a chunk_target_size and Loki will attempt to fill a chunk to approx that size before flushing (previously a chunk size was a hard coded 10 blocks where the default block size is 262144 bytes). Larger chunks are beneficial for a few reasons, mainly on reducing API calls to your object store when performing queries, but also in reducing overhead in a few places, especially when processing very high volume log streams.

Another big improvement is the introduction of accurate rate limiting when running microservices:

  • 1486 pracucci: Add ingestion rate global limit support

Previously the rate limit was applied at each distributor, however with traffic split over many distributors the limit would need to be adjusted accordingly. This meant that scaling up distributors required changing the limit. Now this information is communicated between distributors such that the limit should be applied accurately regardless of the number of distributors.

And last but not least on the notable changes list is a new feature for Promtail:

  • 1275 bastjan: pkg/promtail: IETF Syslog (RFC5424) Support

With this change Promtail can receive syslogs via TCP! Thanks to @bastjan for all the hard work on this submission!

Important things to note:

  • 1519 Changes a core behavior in Loki regarding logs with duplicate content AND duplicate timestamps, previously Loki would store logs with duplicate timestamps and content, moving forward logs with duplicate content AND timestamps will be silently ignored. Mainly this change is to prevent duplicates that appear when a batch is retried (the first entry in the list would be inserted again, now it will be ignored). Logs with the same timestamp and different content will still be accepted.
  • 1486 Deprecated -distributor.limiter-reload-period flag / distributor's limiter_reload_period config option.

All Changes

Once again we can't thank our community and contributors enough for the significant work that everyone is adding to Loki, the entire list of changes is long!!

Loki

  • 1526 codesome: Support for aggregation
  • 1522 cyriltovena: Adds support for the old query string regexp in the frontend.
  • 1519 rfratto: pkg/chunkenc: ignore duplicate lines pushed to a stream
  • 1511 sandlis: querier: fix panic in tailer when max tail duration exceeds
  • 1499 slim-bean: Fix a panic in chunk prefetch
  • 1495 slim-bean: Prefetch chunks while processing
  • 1496 cyriltovena: Add duplicates info and remove timing informations.
  • 1490 owen-d: Fix/deadlock frontend queue
  • 1489 owen-d: unifies reverse iterators
  • 1488 cyriltovena: Fixes response json encoding and add regression tests.
  • 1486 pracucci: Add ingestion rate global limit support* 1493 pracucci: Added max streams per user global limit
  • 1480 cyriltovena: Close iterator properly and check nil before releasing buffers.
  • 1473 rfratto: pkg/querier: don't query all ingesters
  • 1470 cyriltovena: Validates limit parameter.
  • 1448 cyriltovena: Improving storage benchmark
  • 1445 cyriltovena: Add decompression tracing instrumentation.
  • 1442 cyriltovena: Loki Query Frontend
  • 1438 pstibrany: pkg/ingester: added sync period flags
  • 1433 zendern: Using strict parsing for yaml configs
  • 1425 pstibrany: pkg/ingester: Added possibility to disable transfers.
  • 1423 pstibrany: pkg/chunkenc: Fix BenchmarkRead to focus on reading chunks, not converting bytes to string
  • 1421 pstibrany: pkg/chunkenc: change default LZ4 buffer size to 64k.
  • 1420 cyriltovena: Sets the chunk encoding correctly when creating chunk from bytes.
  • 1419 owen-d: Enables Series API in loki
  • 1413 pstibrany: RangeQuery benchmark optimizations
  • 1411 cyriltovena: Adds configurable compression algorithms for chunks
  • 1409 slim-bean: change the chunk size histogram to allow for bigger buckets
  • 1408 slim-bean: forgot to register the new metric for counting blocks per chunk
  • 1406 slim-bean: allow configuring a target chunk size in compressed bytes
  • 1405 pstibrany: Convert string to bytes once only when doing string filtering.
  • 1396 pstibrany: pkg/cfg: print help only when requested, and print it on stdout
  • 1383 beornf: Read websocket close in tail handler
  • 1071 rfratto: pkg/ingester: limit total number of errors a stream can return on push
  • 1545 joe-elliott: Critical n => m conversions
  • 1541 owen-d: legacy endpoint 400s metric queries

Promtail

  • 1515 slim-bean: Promtail: Improve position and size metrics
  • 1485 p37ruh4: Fileglob parsing fixes
  • 1472 owen-d: positions.ignore-corruptions
  • 1453 chancez: pkg/promtail: Initialize counters to 0 when creating client
  • 1436 rfratto: promtail: add support for passing through journal entries as JSON
  • 1426 wphan: Support microsecond timestamp format
  • 1416 pstibrany: pkg/promtail/client: missing URL in client returns error
  • 1275 bastjan: pkg/promtail: IETF Syslog (RFC5424) Support

Fluent Bit

  • 1455 JensErat: fluent-bit-plugin: re-enable failing JSON marshaller tests; pass error instead of logging and ignoring
  • 1294 JensErat: fluent-bit: multi-instance support
  • 1514 shane-axiom: fluent-plugin-grafana-loki: Add fluentd_thread label when flush_thread_count > 1

Fluentd

  • 1500 cyriltovena: Bump fluentd plugin to 1.2.6.
  • 1475 Horkyze: fluentd-plugin: call gsub for strings only

Docker Driver

  • 1414 cyriltovena: Adds tenant-id for docker driver.

Logcli

  • 1492 sandlis: logcli: replaced GRAFANA_* with LOKI_* in logcli env vars, set default server url for logcli to localhost

Helm

  • 1534 olivierboudet: helm : fix fluent-bit parser configuration syntax
  • 1506 terjesannum: helm: add podsecuritypolicy for fluent-bit
  • 1431 eugene100: Helm: fix issue with config.clients
  • 1430 olivierboudet: helm : allow to define custom parsers to use with fluentbit.io/parser annotation
  • 1418 evalsocket: Helm chart url added in helm.md
  • 1336 terjesannum: helm: support adding init containers to the loki pod
  • 1530 WeiBanjo: Allow extra command line args for external labels like hostname

Jsonnet

  • 1518 benjaminhuo: Fix error 'Field does not exist: jaeger_mixin' in tk show
  • 1501 anarcher: jsonnet: fix common/defaultPorts parameters
  • 1497 cyriltovena: Update Loki mixin to include frontend QPS and latency.
  • 1478 cyriltovena: Fixes the typo in the result cache config of the Loki ksonnet lib.
  • 1543 sh0rez: fix(ksonnet): use apps/v1

Docs

  • 1531 fitzoh: Documentation: Add note on using Loki with Amazon ECS
  • 1521 rfratto: docs: Document timestamp ordering rules
  • 1516 rfratto: Link to release docs in README.md, not master docs
  • 1508 cyriltovena: Fixes bad json in Loki API documentation.
  • 1505 sandlis: doc: fix sample yaml in docs for installing promtail to k8s
  • 1481 terjesannum: docs: fix broken promtail link
  • 1474 Eraac: : information about max_look_back_period
  • 1471 cyriltovena: Update README.md
  • 1466 Eraac: : Update IAM requirement
  • 1441 vtereso: : README spelling fix
  • 1437 daixiang0: fix all misspell
  • 1432 joe-elliott: Removed unsupported encodings from docs
  • 1399 vishesh92: Docs: Add configuration docs for redis
  • 1394 chancez: Documentation: Fix example AWS storage configuration
  • 1227 daixiang0: Add docker install doc
  • 1560 robshep: Promtail Docs: Update output.md
  • 1546 mattmendick: Removing third-party link
  • 1539 j18e: docs: fix syntax error in pipeline example

Build

  • 1494 pracucci: Fixed TOUCH_PROTOS in all DroneCI pipelines
  • 1479 owen-d: TOUCH_PROTOS build arg for dockerfile
  • 1476 owen-d: initiates docker daemon for circle windows builds
  • 1469 rfratto: Makefile: re-enable journal scraping on ARM

New Members!

  • 1415 cyriltovena: Add Joe as member of the team.

1.2.0 (2019-12-09)

One week has passed since the last Loki release, and it's time for a new one!

Notable Changes

We have continued our work making our API Prometheus-compatible. The key changes centered around API compatibility are:

  • 1370 slim-bean: Change /loki/api/v1/label to loki/api/v1/labels
  • 1381 owen-d: application/x-www-form-urlencoded support

Meanwhile, @pstibrany has done great work ensuring that Loki handles hash collisions properly:

  • 1247 pstibrany: pkg/ingester: handle labels mapping to the same fast fingerprint.

Other Changes

❤️ All PR's are important to us, thanks everyone for continuing to help support and improve Loki! ❤️

Features

  • 1372 cyriltovena: Let Loki start when using the debug image.
  • 1300 pstibrany: pkg/ingester: check that ingester is in LEAVING state when transferring chunks and claiming tokens. Required when using memberlist client.

Bug Fixes/Improvements

  • 1376 jstaffans: Fluentd: guard against nil values when sanitizing labels
  • 1371 cyriltovena: Logql benchmark and performance improvement.
  • 1363 cyriltovena: Fixes fluentd new push path API.
  • 1353 pstibrany: docs: Fix grpc_listen_host and http_listen_host.
  • 1350 Eraac: documentation: iam requirement for autoscaling

1.1.0 (2019-12-04)

It's been a busy 2 weeks since the 1.0.0 release and quite a few important PR's have been merged to Loki.

The most significant:

  • 1322 rfratto: Fix v1 label API to be Prometheus-compatible

Some might call this a breaking change, we are instead calling it a bug fix as our goal was to be prometheus compatible and we were not 😃

But please be aware if you are using the /loki/api/v1/label or /loki/api/v1/label/<name>/values the JSON result will be different in 1.1.0

Old result:

{
  "values": [
    "label1",
    "label2",
    "labeln"
  ]
}

New result:

{
  "status": "success",
  "data": [
    "label1",
    "label2",
    "labeln"
  ]
}

ALSO IMPORTANT

  • 1160 daixiang0: replace gzip with zip

Binaries will now be zipped instead of gzipped as many people voiced their opinion that zip is likely to be installed on more systems by default.

If you had existing automation to download and install binaries this will have to be updated to use zip instead of gzip

Notable Fixes and Improvements

  • Broken version info in startup log message:

    1095 pstibrany: Makefile changes to allow easy builds with or without vendoring. Also fixes version bug for both cases.

  • The hashing algorithm used to calculate the hash for a stream was creating hash collisions in some instances. Please Note this is just one part of the fix and is only in Promtail, the second part for Loki can be tracked in PR1247 which didn't quite make the cut for 1.1.0 and will be in 1.2.0:

    1254 pstibrany: pkg/promtail/client: Handle fingerprint hash collisions

  • Thank you @putrasattvika for finding and fixing an important bug where logs were some logs were missed in a query shortly after a flush!

    1299 putrasattvika: storage: fix missing logs with batched chunk iterator

  • Thank you @danieldabate for helping to again improve our API to be more Prometheus compatible:

    1355 danieldabate: HTTP API: Support duration and float formats for step parameter

  • LogQL will support duration formats that are not typically handled by Go like [1d] or [1w]

    1357 cyriltovena: Supports same duration format in LogQL as Prometheus

Everything Else

❤️ All PR's are important to us, thanks everyone for continuing to help support and improve Loki! ❤️

  • 1349 Eraac: documentation: using parsable value in example
  • 1343 dgzlopes: doc(configuration): Fix duration format.
  • 1342 whothey: Makefile: add debug symbols to loki and promtail debug builds
  • 1341 adamjohnson01: Update loki helm chart to support service account annotations
  • 1340 adamjohnson01: Pull in cortex changes to support IAM roles for EKS
  • 1339 cyriltovena: Update gem version.
  • 1333 daixiang0: fix broken link
  • 1328 cyriltovena: Fixes linter warning from the yacc file.
  • 1326 dawidmalina: Wrong api endpoint in fluent-plugin-grafana-loki
  • 1320 roidelapluie: Metrics: use Namespace everywhere when declaring metrics
  • 1318 roidelapluie: Use tenant as label name for discarded_samples metrics
  • 1317 roidelapluie: Expose discarded bytes metric
  • 1316 slim-bean: Removing old file needed for dep (no longer needed)
  • 1312 ekeih: Docs: Add missing ) in LogQL example
  • 1311 pstibrany: Include positions filename in the error when YAML unmarshal fails.
  • 1310 JensErat: fluent-bit: sorted JSON and properly convert []byte to string
  • 1304 pstibrany: promtail: write positions to new file first, move to target location afterwards
  • 1303 zhangjianweibj: grafana#1302
  • 1298 rfratto: pkg/promtail: remove journal target forced path
  • 1279 rfratto: Fix loki_discarded_samples_total metric
  • 1278 rfratto: docs: update limits_config to new structure from #948
  • 1276 roidelapluie: Update fluentbit README.md based on my experience
  • 1274 sh0rez: chore(ci): drone-cli
  • 1273 JensErat: fluent-bit: tenant ID configuration
  • 1266 polar3130: add description about tenant stage
  • 1262 Eraac: documentation: iam requirement for autoscaling
  • 1261 rfratto: Document systemd journal scraping
  • 1249 cyriltovena: Move to jsoniter instead of default json package
  • 1223 jgehrcke: authentication.md: replace "user" with "tenant"
  • 1204 allanhung: fluent-bit-plugin: Auto add Kubernetes labels to Loki labels

1.0.0 (2019-11-19)

🎉 Nearly a year since Loki was announced at KubeCon in Seattle 2018 we are very excited to announce the 1.0.0 release of Loki! 🎉

A lot has happened since the announcement, the project just recently passed 1000 commits by 138 contributors over 700+ PR's accumulating over 7700 GitHub stars!

Internally at Grafana Labs we have been using Loki to monitor all of our infrastructure and ingest around 1.5TB/10 billion log lines a day. Since the v0.2.0 release we have found Loki to be reliable and stable in our environments.

We are comfortable with the state of the project in our production environments and think it's time to promote Loki to a non-beta release to communicate to everyone that they should feel comfortable using Loki in their production environments too.

API Stability

With the 1.0.0 release our intent is to try to follow Semver rules regarding stability with some aspects of Loki, focusing mainly on the operating experience of Loki as an application. That is to say we are not planning any major changes to the HTTP API, and anything breaking would likely be accompanied by a major release with backwards compatibility support.

We are currently NOT planning on maintaining Go API stability with this release, if you are importing Loki as a library you should be prepared for any kind of change, including breaking, even in minor or bugfix releases.

Loki is still a young and active project and there might be some breaking config changes in non-major releases, rest assured this will be clearly communicated and backwards or overlapping compatibility will be provided if possible.

Changes

There were not as many changes in this release as the last, mainly we wanted to make sure Loki was mostly stable before 1.0.0. The most notable change is the inclusion of the V11 schema in PR's 1201 and 1280. The V11 schema adds some more data to the index to improve label queries over large amounts of time and series. Currently we have not updated the Helm or Ksonnet to use the new schema, this will come soon with more details on how it works.

The full list of changes:

  • 1280 owen-d: Fix duplicate labels (update cortex)
  • 1260 rfratto: pkg/loki: unmarshal module name from YAML
  • 1257 rfratto: helm: update default terminationGracePeriodSeconds to 4800
  • 1251 obitech: docs: Fix promtail releases download link
  • 1248 rfratto: docs: slightly modify language in community Loki packages section
  • 1242 tarokkk: fluentd: Suppress unread configuration warning
  • 1239 pracucci: Move ReservedLabelTenantID out from a dedicated file
  • 1238 oke-py: helm: loki-stack supports k8s 1.16
  • 1237 joe-elliott: Rollback google.golang.org/api to 0.8.0
  • 1235 woodsaj: ci: update triggers to use new deployment_tools location
  • 1234 rfratto: Standardize schema used in match stage
  • 1233 wapmorgan: Update docker-driver Dockerfile: add tzdb
  • 1232 rfratto: Fix drone deploy job
  • 1231 joe-elliott: Removed references to Loki free tier
  • 1226 clickyotomy: Update dependencies to use weaveworks/common upstream
  • 1221 slim-bean: use regex label matcher to not alert on any tail route latencies
  • 1219 MightySCollins: docs: Updated Kubernetes docs links in Helm charts
  • 1218 slim-bean: update dashboards to include the new /loki/api/v1/* endpoints
  • 1217 slim-bean: sum the bad words by name and level
  • 1216 joe-elliott: Remove rules that reference no longer existing metrics
  • 1215 Eraac: typo url
  • 1214 takanabe: Correct wrong document paths about querying
  • 1213 slim-bean: Fix docker latest and master tags
  • 1212 joe-elliott: Update loki operational
  • 1206 sandlis: ksonnet: fix replication always set to 3 in ksonnet
  • 1203 joe-elliott: Chunk iterator performance improvement
  • 1202 beorn7: Simplify regexp's
  • 1201 cyriltovena: Update cortex to bring v11 schema
  • 1189 putrasattvika: fluent-plugin: Add client certificate verification
  • 1186 tarokkk: fluentd: Refactor label_keys and and add extract_kubernetes_labels configuration

0.4.0 (2019-10-24)

A huge thanks to the 36 contributors who submitted 148 PR's since 0.3.0!

Notable Changes

  • With PR 654 @cyriltovena added a really exciting new capability to Loki, a Prometheus compatible API with support for running metric style queries against your logs! Take a look at how to write metric queries for logs

    PLEASE NOTE: To use metric style queries in the current Grafana release 6.4.x you will need to add Loki as a Prometheus datasource in addition to having it as a Log datasource and you will have to select the correct source for querying logs vs metrics, coming soon Grafana will support both logs and metric queries directly to the Loki datasource!

  • PR 1022 (and a few others) @joe-elliott added a new set of HTTP endpoints in conjunction with the work @cyriltovena to create a Prometheus compatible API as well as improve how labels/timestamps are handled

    IMPORTANT: The new /api/v1/* endpoints contain breaking changes on the query paths (push path is unchanged) Eventually the /api/prom/* endpoints will be removed

  • PR 847 owes a big thanks to @cosmo0920 for contributing his Fluent Bit go plugin, now loki has Fluent Bit plugin support!!

  • PR 982 was a couple weeks of painstaking work by @rfratto for a much needed improvement to Loki's docs! Check them out!

  • PR 980 by @sh0rez improved how flags and config file's are loaded to honor a more traditional order of precedence:

    1. Defaults
    2. Config file
    3. User-supplied flag values (command line arguments)

    PLEASE NOTE: This is potentially a breaking change if you were passing command line arguments that also existed in a config file in which case the order they are given priority now has changed!

  • PR 1062 and 1089 have moved Loki from Dep to Go Modules and to Go 1.13

Loki

Features/Improvements/Changes

  • Loki 1171 cyriltovena: Moves request parsing into the loghttp package
  • Loki 1145 joe-elliott: Update /loki/api/v1/push to use the v1 json format
  • Loki 1128 sandlis: bigtable-backup: list backups just before starting deletion of wanted backups
  • Loki 1100 sandlis: logging: removed some noise in logs from live-tailing
  • Loki/build 1089 joe-elliott: Go 1.13
  • Loki 1088 pstibrany: Updated cortex to latest master.
  • Loki 1085 pracucci: Do not retry chunks transferring on shutdown in the local dev env
  • Loki 1084 pracucci: Skip ingester tailer filtering if no filter is set
  • Loki/build1062 joe-elliott: dep => go mod
  • Loki 1049 joe-elliott: Update loki push path
  • Loki 1044 joe-elliott: Fixed broken logql request filtering
  • Loki/tools 1043 sandlis: bigtable-backup: use latest bigtable backup docker image with fix for list backups
  • Loki 1030 polar3130: fix typo in error messages
  • Loki/tools 1028 sandlis: bigtable-backup: verify backups to work on latest list of backups
  • Loki 1022 joe-elliott: Loki HTTP/JSON Model Layer
  • Loki 1016 slim-bean: Revert "Updated stream json objects to be more parse friendly (#1010)"
  • Loki 1010 joe-elliott: Updated stream json objects to be more parse friendly
  • Loki 1009 cyriltovena: Make Loki HTTP API more compatible with Prometheus
  • Loki 1008 wardbekker: Improved Ingester out-of-order error for faster troubleshooting
  • Loki 1001 slim-bean: Update new API paths
  • Loki 998 sandlis: Change unit of duration params to hours to align it with duration config at other places in Loki
  • Loki 980 sh0rez: feat: configuration source precedence
  • Loki 948 sandlis: limits: limits implementation for loki
  • Loki 947 sandlis: added a variable for storing periodic table duration as an int to be …
  • Loki 938 sandlis: vendoring: update cortex to latest master
  • Loki/tools 930 sandlis: fix incrementing of bigtable_backup_job_backups_created metric
  • Loki/tools 920 sandlis: bigtable-backup tool fix
  • Loki/tools 895 sandlis: bigtable-backup-tool: Improvements
  • Loki 755 sandlis: Use grpc client config from cortex for Ingester to get more control
  • Loki 654 cyriltovena: LogQL: Vector and Range Vector Aggregation.

Bug Fixes

  • Loki 1114 rfratto: pkg/ingester: prevent shutdowns from processing during joining handoff
  • Loki 1097 joe-elliott: Reverted cloud.google.com/go to 0.44.1
  • Loki 986 pracucci: Fix panic in tailer due to race condition between send() and close()
  • Loki 975 sh0rez: fix(distributor): parseError BadRequest
  • Loki 944 rfratto: pkg/querier: fix concurrent access to querier tail clients

Promtail

Features/Improvements/Changes

  • Promtail/pipeline 1179 pracucci: promtail: fix handling of JMESPath expression returning nil while parsing JSON
  • Promtail/pipeline 1123 pracucci: promtail: added action_on_failure support to timestamp stage
  • Promtail/pipeline 1122 pracucci: promtail: initialize extracted map with initial labels
  • Promtail/pipeline 1112 cyriltovena: Add logql filter to match stages and drop capability
  • Promtail/journal 1109 rfratto: Clarify journal warning
  • Promtail 1083 pracucci: Increased promtail's backoff settings in prod and improved doc
  • Promtail 1026 erwinvaneyk: promtail: fix externalURL and path prefix issues
  • Promtail 976 slim-bean: Wrap debug log statements in conditionals to save allocations
  • Promtail 973 ctrox: tests: Set default value for BatchWait as ticker does not accept 0
  • Promtail 969 ctrox: promtail: Use ticker instead of timer for batch wait
  • Promtail 952 pracucci: promtail: add metrics on sent and dropped log entries
  • Promtail 934 pracucci: promtail: do not send the last batch - to ingester - if empty
  • Promtail 921 rfratto: promtail: add "max_age" field to configure cutoff for journal reading
  • Promtail 883 adityacs: Add pipeline unit testing to promtail

Bugfixes

  • Promtail 1194 slim-bean: Improve how we record file size metric to avoid a race in our file lagging alert
  • Promtail/journal 1072 rfratto: build: enable journal in promtail linux release build

Docs

  • Docs 1176 rfratto: docs: add example and documentation about using JMESPath literals
  • Docs 1139 joe-elliott: Moved client docs and add serilog example
  • Docs 1132 kailwallin: FixedTypo.Update README.md
  • Docs 1130 pracucci: docs: fix Promtail / Loki capitalization
  • Docs 1129 pracucci: docs: clarified the relation between retention period and table period
  • Docs 1124 geowa4: Client recommendations documentation tweaks
  • Docs 1106 cyriltovena: Add fluent-bit missing link in the main documentation page.
  • Docs 1099 pracucci: docs: improve table manager documentation
  • Docs 1094 rfratto: docs: update stages README with the docker and cri stages
  • Docs 1091 daixiang0: docs(stage): add docker and cri
  • Docs 1077 daixiang0: doc(fluent-bit): add missing namespace
  • Docs 1073 flouthoc: Re Fix Docs: PR grafana#1053 got erased due to force push.
  • Docs 1069 daixiang0: doc: unify GOPATH
  • Docs 1068 daixiang0: doc: skip jb init when using Tanka
  • Docs 1067 rfratto: Fix broken links to docs in README.md
  • Docs 1064 jonaskello: Fix spelling of HTTP header
  • Docs 1063 rfratto: docs: fix deprecated warning in api.md
  • Docs 1060 rfratto: Add Drone CI badge to README.md
  • Docs 1053 flouthoc: Fix Docs: Change Imagepull policy to IfNotpresent / Add loki-canary b…
  • Docs 1048 wassan128: Loki: Fix README link
  • Docs 1042 daixiang0: doc(ksonnet): include ksonnet-lib
  • Docs 1039 sh0rez: doc(production): replace ksonnet with Tanka
  • Docs 1036 sh0rez: feat: -version flag
  • Docs 1025 oddlittlebird: Update CONTRIBUTING.md
  • Docs 1024 oddlittlebird: Update README.md
  • Docs 1014 polar3130: Fix a link to correct doc and fix a typo
  • Docs 1006 slim-bean: fixing lots of broken links and a few typos
  • Docs 1005 SmilingNavern: Fix links to correct doc
  • Docs 1004 rfratto: docs: fix example with pulling systemd logs
  • Docs 1003 oddlittlebird: Loki: Update README.md
  • Docs 984 tomgs: Changing "Usage" link in main readme after docs change
  • Docs 983 daixiang0: update positions.yaml location reference
  • Docs 982 rfratto: Documentation Rewrite
  • Docs 961 worr: doc: Add permissions that IAM roles for Loki need
  • Docs 933 pracucci: doc: move promtail doc into dedicated subfolder
  • Docs 924 pracucci: doc: promtail known failure modes
  • Docs 910 slim-bean: docs(build): Update docs around releasing and fix bug in version updating script
  • Docs 850 sh0rez: docs: general documentation rework

Build

  • Build 1157 daixiang0: Update golint
  • Build 1133 daixiang0: bump up golangci to 1.20
  • Build 1121 pracucci: Publish loki-canary binaries on release
  • Build 1054 pstibrany: Fix dep check warnings by running dep ensure
  • Build/release 1018 slim-bean: updating the image version for loki-canary and adding the version increment to the release_prepare script
  • Build/CI 997 slim-bean: full circle
  • Build/CI 996 rfratto: ci/drone: fix deploy command by escaping double quotes in JSON body
  • Build/CI 995 slim-bean: use the loki-build-image for calling circle
  • Build/CI 994 slim-bean: Also need bash for the deploy step from drone
  • Build/CI 993 slim-bean: Add make to the alpine image used for calling the circle deploy task from drone.
  • Build/CI 992 sh0rez: chore(packaging): fix GOPATH being overwritten
  • Build/CI 991 sh0rez: chore(packaging): deploy from drone
  • Build/CI 990 sh0rez: chore(ci/cd): breaking the circle
  • Build 989 sh0rez: chore(packaging): simplify tagging
  • Build 981 sh0rez: chore(packaging): loki windows/amd64
  • Build 958 daixiang0: sync release pkgs name with release note
  • Build/CI 914 rfratto: ci: update apt-get before installing deps for rootless step
  • Build 911 daixiang0: optimize image tag script

Deployment

  • Ksonnet 1023 slim-bean: make promtail daemonset name configurable
  • Ksonnet 1021 rfratto: ksonnet: update memcached and memcached-exporter images
  • Ksonnet 1020 rfratto: ksonnet: use consistent hashing in memcached client configs
  • Ksonnet 1017 slim-bean: make promtail configmap name configurable
  • Ksonnet 946 rfratto: ksonnet: remove prefix from kvstore.consul settings in loki config
  • Ksonnet 926 slim-bean: feat(promtail): Make cluster role configurable
  • Helm 1174 rally25rs: loki-stack: Add release name to prometheus service name.
  • Helm 1152 nicr9: docs(helm): fix broken link to grafana datasource
  • Helm 1134 minhdanh: Helm chart: Allow additional scrape_configs to be added
  • Helm 1111 ekarlso: helm: Add support for passing arbitrary secrets
  • Helm 1110 marcosnils: Bump grafana image in loki helm chart
  • Helm 1104 marcosnils: : Deploy prometheus from helm chart
  • Helm 1058 polar3130: Helm: Remove default value of storageClassName in loki/loki helm chart
  • Helm 1056 polar3130: Helm: Fix the reference error of loki/loki helm chart
  • Helm 967 makocchi-git: helm chart: Add missing operator to promtail
  • Helm 937 minhdanh: helm chart: Add support for additional labels and scrapeTimeout for serviceMonitors
  • Helm 909 angelbarrera92: Feature: Add extra containers to loki helm chart
  • Helm 855 ikeeip: set helm chart appVersion while release
  • Helm 675 cyriltovena: Helm default ingester config

Loki Canary

  • Loki-canary 1137 slim-bean: Add some additional logging to the canary on queries
  • Loki-canary 1131 rfratto: pkg/canary: use default HTTP client when reading from Loki

Logcli

  • Logcli 1168 sh0rez: feat(cli): order flags by categories
  • Logcli 1115 pracucci: logcli: introduced QueryStringBuilder utility to clean up query string encoding
  • Logcli 1103 pracucci: logcli: added --step support to query command
  • Logcli 987 joe-elliott: Logcli: Add Support for New Query Path

Tooling

  • Dashboards 1188 joe-elliott: Adding Operational dashboards
  • Dashboards 1143 joe-elliott: Improved compression ratio histogram
  • Dashboards 1126 joe-elliott: Fix Loki Chunks Dashboard
  • Tools 1108 joe-elliott: Updated push path to current prod

Plugins

  • DockerDriver 972 cyriltovena: Add stream label to docker driver
  • DockerDriver 971 cyriltovena: Allow to pass max-size and max-file to the docker driver
  • DockerDriver 970 mindfl: docker-driver compose labels support
  • Fluentd 928 candlerb: fluent-plugin-grafana-loki: Escape double-quotes in labels, and suppress labels with value nil
  • Fluent Bit 1155 cyriltovena: rollback fluent-bit push path until we release 0.4
  • Fluent Bit 1096 JensErat: fluent-bit: edge case tests
  • Fluent Bit 847 cosmo0920: fluent-bit shared object go plugin

Misc

Loki is now using a Bot to help keep issues and PR's pruned based on age/relevancy. Please don't hesitate to comment on an issue or PR that you think was closed by the stale-bot which you think should remain open!!

  • Github 965 rfratto: Change label used to keep issues from being marked as stale to keepalive
  • Github 964 rfratto: Add probot-stale configuration to close stale issues.

0.3.0 (2019-08-16)

Features/Enhancements

  • Loki 877 pracucci: loki: Improve Tailer loop
  • Loki 870 sandlis: bigtable-backup: update docker image for bigtable-backup tool
  • Loki 862 sandlis: live-tailing: preload all the historic entries before query context is cancelled
  • Loki 858 pracucci: loki: removed unused TestGZIPCompression
  • Loki 854 adityacs: Readiness probe for querier
  • Loki 851 cyriltovena: Add readiness probe to distributor deployment.
  • Loki 894 rfratto: ksonnet: update ingester config to transfer chunks on rollout
  • Build 901 sh0rez: chore(packaging): set tag length to 7
  • Build 900 sh0rez: chore(ci/cd): fix grafanasaur credentials and CircleCI image build
  • Build 891 sh0rez: chore(ci/cd): build containers using drone.io
  • Build 888 rfratto: Makefile: disable building promtail with systemd support on non-amd64 platforms
  • Build 887 slim-bean: chore(packaging): Dockerfile make avoid containers
  • Build 886 sh0rez: chore(packaging): wrong executable format
  • Build 855 ikeeip: set helm chart appVersion while release
  • Promtail 856 martinbaillie: promtail: Add ServiceMonitor and headless Service
  • Promtail 809 rfratto: Makefile: build promtail with CGO_ENABLED if GOHOSTOS=GOOS=linux
  • Promtail 730 rfratto: promtail: Add systemd journal support

809, 730 NOTE: Systemd journal support is currently limited to amd64 images, arm support should come in the future when the transition to building the arm image and binaries is done natively via an arm container

  • Docs 896 dalance: docs: fix link format
  • Docs 876 BouchaaraAdil: update Docs: update Retention section on Operations doc file
  • Docs 864 temal-: docs: Replace old values in operations.md
  • Docs 853 cyriltovena: Add governance documentation
  • Deployment 874 slim-bean: make our ksonnet a little more modular by parameterizing the chunk and index stores
  • Deployment 857 slim-bean: Reorder relabeling rules to prevent pod label from overwriting config define labels

857 POSSIBLY BREAKING: If you relied on a custom pod label to overwrite one of the labels configured by the other sections of the scrape config: job, namespace, instance, container_name and/or __path__, this will no longer happen, the custom pod labels are now loaded first and will be overwritten by any of these listed labels.

Fixes

  • Loki 897 pracucci: Fix panic in tailer when an ingester is removed from the ring while tailing
  • Loki 880 cyriltovena: fix a bug where nil line buffer would be put back
  • Loki 859 pracucci: loki: Fixed out of order entries allowed in a chunk on edge case
  • Promtail 893 rfratto: pkg/promtail/positions: remove executable bit from positions file
  • Deployment 867 slim-bean: Update read dashboard to include only query and label query routes
  • Deployment 865 sandlis: fix broken jsonnet for querier
  • Canary 889 slim-bean: fix(canary): Fix Flaky Tests
  • Pipeline 869 jojohappy: Pipeline: Fixed labels process test with same objects
  • Logcli 863 adityacs: Fix Nolabels parse metrics

0.2.0 (2019-08-02)

There were over 100 PR's merged since 0.1.0 was released, here's a highlight:

Features / Enhancements

  • Loki: 521 Query label values and names are now fetched from the store.
  • Loki: 541 Improvements in live tailing of logs.
  • Loki: 713 Storage memory improvement.
  • Loki: 764 Tailing can fetch previous logs for context.
  • Loki: 782 Performance improvement: Query storage by iterating through chunks in batches.
  • Loki: 788 Querier timeouts.
  • Loki: 794 Support ingester chunk transfer on shutdown.
  • Loki: 729 Bigtable backup tool support.
  • Pipeline: 738 Added a template stage for manipulating label values.
  • Pipeline: 732 Support for Unix timestamps.
  • Pipeline: 760 Support timestamps without year.
  • Helm: 641 Helm integration testing.
  • Helm: 824 Add service monitor.
  • Helm: 830 Customize namespace.
  • Docker-Plugin: 663 Created a Docker logging driver plugin.
  • Fluent-Plugin: 669 Ability to specify keys to remove.
  • Fluent-Plugin: 709 Multi-worker support.
  • Fluent-Plugin: 792 Add prometheus for metrics and update gems.
  • Build: 668,762 Build multiple architecture containers.
  • Loki-Canary: 772 Moved into Loki project.

Bugfixes

There were many fixes, here are a few of the most important:

  • Promtail: 650 Build on windows.
  • Fluent-Plugin: 667 Rename fluent plugin.
  • Docker-Plugin: 813 Fix panic for newer docker version (18.09.7+).

0.1.0 (2019-06-03)

First (beta) Release!