Commit Graph

84 Commits

Author SHA1 Message Date
Bruno Cadonna 9c80a06466 KAFKA-8942: Document RocksDB metrics
Author: Bruno Cadonna <bruno@confluent.io>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #7490 from cadonna/AK8942-docs-rocksdb_metrics

Minor comments
2019-10-15 11:13:43 -07:00
David Arthur c1f2b0ffb8 KAFKA-8753; Expose controller topic deletion metrics (KIP-503) (#7156)
This is the implementation for [KIP-503](https://cwiki.apache.org/confluence/display/KAFKA/KIP-503%3A+Add+metric+for+number+of+topics+marked+for+deletion)

When deleting a large number of topics, the Controller can get quite bogged down. One problem with this is the lack of visibility into the progress of the Controller. We can look into the ZK path for topics marked for deletion, but in a production environment this is inconvenient. This PR adds a JMX metric `kafka.controller:type=KafkaController,name=TopicsToDeleteCount` to make it easier to see how many topics are being deleted.

Reviewers: Stanislav Kozlovski <stanislav@confluent.io>, Jun Rao <junrao@gmail.com>, Jason Gustafson <jason@confluent.io>
2019-08-23 13:22:41 -07:00
anatasiavela 0b1dc1ca7b KAFKA-6263; Expose metrics for group and transaction metadata loading duration
[JIRA](https://issues.apache.org/jira/browse/KAFKA-6263)

- Add metrics to provide visibility for how long group metadata and transaction metadata take to load in order to understand some inactivity seen in the consumer groups
- Tests include mocking load times by creating a delay after each are loaded and ensuring the measured JMX metric is as it should be

Author: anatasiavela <anastasiavela@berkeley.edu>

Reviewers: Gwen Shapira, Jason Gustafson

Closes #7045 from anatasiavela/KAFKA-6263
2019-08-03 21:00:46 -07:00
Ismael Juma 22d4ccd8ac
MINOR: Update docs to reflect the ZK 3.5.5 upgrade (#7149)
Reviewers: Manikumar Reddy <manikumar.reddy@gmail.com>
2019-08-02 06:09:51 -07:00
opera443399 96096cebe1 MINOR: docs typo in '--zookeeper myhost:2181--execute'
this PR will fix a typo related to docs:
http://kafka.apache.org/21/documentation.html#rep-throttle

```bash
$ bin/kafka-reassign-partitions.sh --zookeeper myhost:2181--execute --reassignment-json-file bigger-cluster.json —throttle 50000000
```

I think `myhost:2181` should be `localhost:2181` and followed by a `space`

Author: opera443399 <pc@pcswo.com>

Reviewers: Gwen Shapira

Closes #6704 from opera443399/docs-ops-typo
2019-05-09 22:16:13 -07:00
Rajini Sivaram 950cfe3e70 MINOR: Add security considerations for remote JMX in Kafka docs (#6544)
Reviewers: Manikumar Reddy <manikumar.reddy@gmail.com>
2019-04-10 12:39:11 +05:30
Kevin Lu 31d191fc85 KAFKA-7904; Add AtMinIsr partition metric and TopicCommand option (KIP-427)
- Add `AtMinIsrPartitionCount` metric to `ReplicaManager`
- Add `AtMinIsr` metric to `Partition`
- Add `--at-min-isr-partitions` describe `TopicCommand` option

https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=103089398

Author: Kevin Lu <lu.kevin@berkeley.edu>
Author: lu.kevin@berkeley.edu <kelu@paypal.com>

Reviewers: Gwen Shapira

Closes #6421 from KevinLiLu/KAFKA-7904
2019-04-05 09:14:41 -07:00
A. Sophie Blee-Goldman ff603c63bb KAFKA-4730: Streams does not have an in-memory windowed store (#6239)
Implemented an in-memory window store allowing for range queries. A finite retention period defines how long records will be kept, ie the window of time for fetching, and the grace period defines the window within which late-arriving data may still be written to the store.

Unit tests were written to test the functionality of the window store, including its insert/update/delete and fetch operations. Single-record, all records, and range fetch were tested, for both time ranges and key ranges. The logging and metrics for late-arriving (dropped)records were tested as well as the ability to restore from a changelog.

Reviewers: John Roesler <john@confluent.io>, Matthias J. Sax <matthias@confluent.io>, Bill Bejeck <bill@confluent.io>, Guozhang Wang <wangguoz@gmail.com>
2019-02-20 19:09:50 -08:00
lambdaliu 826b6d9424 MINOR: fix docs of common per-broker metrics
Author: lambdaliu <lambdaliu@tencent.com>

Reviewers: Manikumar Reddy <manikumar.reddy@gmail.com>

Closes #6212 from lambdaliu/fix_metrics_error
2019-02-13 11:45:59 +05:30
Viktor Somogyi-Vass 776041db11 KAFKA-7804: Update docs for topic-command related KIP-377
This PR adds a upgrade notes and changes examples to use the bootstrap-server.

Author: Viktor Somogyi-Vass <viktorsomogyi@gmail.com>

Reviewers: Srinivas <srinivas96alluri@gmail.com>, Manikumar Reddy <manikumar.reddy@gmail.com>

Closes #6118 from viktorsomogyi/topiccommand-adminclient-doc
2019-02-04 13:46:33 -08:00
John Roesler fdd33bcab0 KAFKA-7223: document suppression buffer metrics (#6024)
Document the new metrics added in #5795

Reviewers: Bill Bejeck <bill@confluent.io>, Guozhang Wang <wangguoz@gmail.com>
2018-12-12 18:22:54 -08:00
lu.kevin@berkeley.edu e869d8f7b4 MINOR: Improve docs by adding ToC links to Monitoring
My top 2 reasons for visiting the Kafka docs are to:
- View configurations
- View metrics

This PR aims to improve the user experience for viewing metrics:
- Add href links to the `Monitoring` section of the Table of Contents so users do not need to scroll or Ctrl/Cmd-F to find specific metric details (Monitoring section has grown large as more component & metrics are added)

Author: lu.kevin@berkeley.edu <kelu@paypal.com>

Reviewers: Viktor Somogyi <viktorsomogyi@gmail.com>, Manikumar Reddy <manikumar.reddy@gmail.com>

Closes #5511 from KevinLiLu/feature/minor-improve-docs
2018-11-28 12:13:26 +05:30
Ron Dagostino e8a3bc7425 KAFKA-7352; Allow SASL Connections to Periodically Re-Authenticate (KIP-368) (#5582)
KIP-368 implementation to enable periodic re-authentication of SASL clients. Also adds a broker configuration option to terminate client connections that do not re-authenticate within the configured interval.
2018-10-26 23:18:15 +01:00
John Roesler 4b7148a5b6 KAFKA-7223: Suppression documentation (#5787)
Reviewers: Matthias J. Sax <matthias@confluent.io>, Bill Bejeck <bill@confluent.io>
2018-10-15 21:04:01 -07:00
Alex Dunayevsky bf0675ac5f KAFKA-6343 Documentation update in OS-level tuning section: add vm.ma… (#4358)
Reviewers: Manikumar Reddy O <manikumar.reddy@gmail.com>, Ismael Juma <ismael@juma.me.uk>, Jun Rao <junrao@gmail.com>
2018-08-22 10:13:10 -07:00
Manikumar Reddy O 49c5994dd9 KAFKA-7063; Remove references to old producers and consumers in docs (#5240)
Reviewers: Vahid Hashemian <vahidhashemian@us.ibm.com>, Ismael Juma <ismael@juma.me.uk>, Jason Gustafson <jason@confluent.io>
2018-08-21 14:02:14 -07:00
Mayank Tankhiwale da35cd5114 KAFKA-6312; Document --reset-offsets option for consumer group tool (#4527)
KIP-122 added the ability for kafka-consumer-groups.sh to reset/change consumer offsets, at a fine grained level. This patch adds documentation for this feature.

Reviewers: Manikumar Reddy O <manikumar.reddy@gmail.com>, Jason Gustafson <jason@confluent.io>
2018-08-20 13:27:44 -07:00
Kevin Lu fb8eba3d33 KAFKA-7207: Make rate & total metrics documentation consistent (#5429)
Some sections of the Monitoring metrics documentation list out the -total metrics, and some sections do not list them out. Make them consistent and list out the missing -total metrics.
2018-08-07 08:49:57 +01:00
Guozhang Wang 6bfaf4dc60
MINOR: Store metrics scope, total metrics (#5290)
1. Rename metrics scope of rocksDB window and session stores; also modify the store metrics accordingly with guidance on its correlations to metricsScope.

2. Add the missing total metrics for per-thread, per-task, per-node and per-store sensors.


Reviewers: John Roesler <john@confluent.io>, Bill Bejeck <bill@confluent.io>, Matthias J. Sax <matthias@confluent.io>
2018-06-28 14:32:02 -07:00
Ismael Juma e70a191d30
KAFKA-4423: Drop support for Java 7 (KIP-118) and update deps (#5046)
* Set --source, --target and --release to 1.8.
* Build Scala 2.12 by default.
* Remove some conditionals in the build file now that Java 8
is the minimum version.
* Bump the version of Jetty, Jersey and Checkstyle (the newer
versions require Java 8).
* Fixed issues uncovered by the new version if Checkstyle.
* A couple of minor updates to handle an incompatible source
change in the new version of Jetty.
* Add dependency to jersey-hk2 to fix failing tests caused
by Jersey upgrade.
* Update release script to use Java 8 and to take into account
that Scala 2.12 is now built by default.
* While we're at it, bump the version of Gradle, Gradle plugins,
ScalaLogging, JMH and apache directory api.
* Minor documentation updates including the readme and upgrade
notes. A number of Streams Java 7 examples can be removed
subsequently.
2018-05-21 23:17:42 -07:00
John Roesler 12a0f46895 KAFKA-6376: Document skipped records metrics changes (#4922)
Reviewers: Bill Bejeck <bill@confluent.io>, Guozhang Wang <wangguoz@gmail.com>
2018-04-24 15:40:16 -07:00
wushujames 75df8cc77a MINOR: Add docs for ReplicationBytesInPerSec and ReplicationBytesOutPerSec (#4595)
Add docs for the ReplicationBytesInPerSec and ReplicationBytesOutPerSec metrics. These metrics were introduced in KIP-153 (KAFKA-5194) but the docs were not updated.

Built site-docs, and viewed them in a web browser to confirm.

Reviewers: Mickael Maison <mickael.maison@gmail.com>, Ismael Juma <ismael@juma.me.uk>
2018-02-20 13:53:49 -08:00
Vahid Hashemian 8b60c8b141 MINOR: Update docs for KIP-229 (#4499)
This PR includes:
* Minor fix to command line output message
* Relevant documentation update
2018-02-01 22:04:14 -08:00
Vahid Hashemian 82020629c5 MINOR: Update consumer group command documentation with additionally supported options (#4462)
With KIP-175 there are a number of consumer group command options that can be used to describe a consumer group.
This PR updates the documentation on consumer group command to mention those options.
2018-01-25 09:25:29 -08:00
Rajini Sivaram 35c1be7469 KAFKA-5746; Document new broker metrics added for health checks
Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #4026 from rajinisivaram/MINOR-KIP-188-metrics-docs
2017-12-20 13:37:42 +00:00
Manikumar Reddy 9b53c31d08 MINOR: Update docs wrt topic deletion being enabled by default
Author: Manikumar Reddy <manikumar.reddy@gmail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #3835 from omkreddy/update-delete-topic-doc
2017-10-27 14:41:46 +01:00
Randall Hauch 11afff0990 KAFKA-5990: Enable generation of metrics docs for Connect (KIP-196)
A new mechanism was added recently to the Metrics framework to make it easier to generate the documentation. It uses a registry with a MetricsNameTemplate for each metric, and then those templates are used when creating the actual metrics. The metrics framework provides utilities that can generate the HTML documentation from the registry of templates.

This change moves the recently-added Connect metrics over to use these templates and to then generate the metric documentation for Connect.

This PR is based upon #3975 and can be rebased once that has been merged.

Author: Randall Hauch <rhauch@gmail.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #3987 from rhauch/kafka-5990
2017-10-04 11:05:50 -07:00
Vahid Hashemian cdbf806e2d KAFKA-5495; Update docs to use `kafka-consumer-groups.sh` for checking consumer offsets
And remove the deprecated `ConsumerOffsetChecker` example.

Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #3405 from vahidhashemian/KAFKA-5495
2017-10-02 12:46:05 -07:00
James Cheng 2fb5664bf4 KAFKA-5597: Autogenerate producer sender metrics
Subtask of https://issues.apache.org/jira/browse/KAFKA-3480

The changes are very similar to what was done for the consumer in https://issues.apache.org/jira/browse/KAFKA-5191 (pull request https://github.com/apache/kafka/pull/2993)

Author: James Cheng <jylcheng@yahoo.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>, Rajini Sivaram <rajinisivaram@googlemail.com>, Guozhang Wang <wangguoz@gmail.com>

Closes #3535 from wushujames/producer_sender_metrics_docs

Fix one minor naming bug
2017-09-05 17:38:58 -07:00
Eno Thereska 6bee1e9e57 HOTFIX: Fixes to metric names of Streams
A couple of fixes to metric names to match the KIP
- Removed extra strings in the metric names that are already in the tags
- add a separate metric for "all"

Author: Eno Thereska <eno.thereska@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #3491 from enothereska/hotfix-metric-names
2017-08-03 14:16:47 -07:00
Dong Lin 4003c9384b KAFKA-5341; Add UnderMinIsrPartitionCount and per-partition UnderMinIsr metrics (KIP-164)
Author: Dong Lin <lindong28@gmail.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #3583 from lindong28/KAFKA-5341
2017-07-28 11:28:33 -07:00
Jeff Klukas 0816e47bfe MINOR: Docs update, Java clients use Kafka Metrics
This contribution is my original work and I license the work to the project under the project's open source license.

Author: Jeff Klukas <jeff@klukas.net>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #3249 from jklukas/docs-no-more-yammer-metrics-in-client
2017-07-20 12:31:17 +01:00
Vahid Hashemian 3bfc073f03 MINOR: Make 'Topic-Level Configs' a doc section for easier access
Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>

Closes #3415 from vahidhashemian/doc/make_topic_config_a_section
2017-07-19 14:25:02 +01:00
huxihx 6d203361a0 KAFKA-5508; Documentation for altering topics
Operations documentation should guide user to employ `kafka-configs.sh` to add/remove configs for a topic.

Author: huxihx <huxi_2b@hotmail.com>

Reviewers: Damian Guy <damian.guy@gmail.com>

Closes #3429 from huxihx/KAFKA-5508_Doc_for_altering_topics
2017-07-06 10:10:03 +01:00
Eno Thereska d1a279dcc7 MINOR: Cache metrics were missing
Author: Eno Thereska <eno.thereska@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #3262 from enothereska/minor-missing-metric
2017-06-07 20:52:54 -07:00
Guozhang Wang 57b0d0fe57 MINOR: syntax brush for java / bash / json / text
Author: Guozhang Wang <wangguoz@gmail.com>

Reviewers: Derrick Or <derrickor@gmail.com>, Ismael Juma <ismael@juma.me.uk>

Closes #3214 from guozhangwang/KMinor-doc-java-brush
2017-06-07 15:17:25 +01:00
Rajini Sivaram b38b74bb77 MINOR: Fix doc for producer throttle time metrics
Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>, Jun Rao <junrao@gmail.com>

Closes #3169 from rajinisivaram/MINOR-producer-metrics
2017-05-30 16:35:25 -07:00
James Cheng 0bc4f75eed KAFKA-5191: Autogenerate Consumer Fetcher metrics
Autogenerate docs for the Consumer Fetcher's metrics. This is a smaller subset of the original PR https://github.com/apache/kafka/pull/1202.

CC ijuma benstopford hachikuji

Author: James Cheng <jylcheng@yahoo.com>

Reviewers: Ismael Juma <ismael@juma.me.uk>, Guozhang Wang <wangguoz@gmail.com>

Closes #2993 from wushujames/fetcher_metrics_docs
2017-05-26 15:34:20 -07:00
Rajini Sivaram 670193f22d KAFKA-4957; Request rate quotas documentation
Author: Rajini Sivaram <rajinisivaram@googlemail.com>

Reviewers: Jun Rao <junrao@gmail.com>

Closes #3069 from rajinisivaram/KAFKA-4957
2017-05-16 16:36:25 -07:00
Vahid Hashemian be11272818 MINOR: Fix a documentation typo
Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Sriharsha Chintalapani <harsha@hortonworks.com>

Closes #2674 from vahidhashemian/minor/fix_typos_1703
2017-03-15 11:50:57 -07:00
Eno Thereska 2e1b00f262 MINOR: Stream metrics documentation
Author: Eno Thereska <eno@confluent.io>

Reviewers: Matthias J. Sax, Guozhang Wang

Closes #2542 from enothereska/minor-streams-metrics
2017-02-15 16:32:02 -08:00
Alex Loddengaard 8bd8751aa7 MINOR: changes to the production broker configuration docs.
Author: Alex Loddengaard <alexloddengaard@gmail.com>

Reviewers: Jun Rao <junrao@gmail.com>

Closes #2519 from alexlod/production-config-docs
2017-02-08 17:18:55 -08:00
huxi be98865dfc KAFKA-4727; A Production server configuration needs to be updated
1. Update value for queued.max.requests to 500
2. Removed invalid config 'controller.message.queue.size'
3. Removed flush configs including 'log.flush.interval.messages', 'log.flush.interval.ms' and 'log.flush.scheduler.interval.ms'

Author: huxi <huxi@zhenrongbao.com>

Reviewers: Grant Henke <granthenke@gmail.com>, Jun Rao <junrao@gmail.com>

Closes #2490 from amethystic/kafka4727_server_config_doc_update
2017-02-07 08:40:30 -08:00
Vahid Hashemian 63cf0e5877 MINOR: Update consumer group describe output in the documentation
Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2409 from vahidhashemian/doc/update_consumer_group_describe_output
2017-01-24 16:24:19 -08:00
Scott Ferguson 05d7664317 MINOR: fixup typo in ops.html
pretty boring docfix, "no" -> "not"

Author: Scott Ferguson <smferguson@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2269 from smferguson/fixup_typo_in_add_remove_topics
2016-12-21 11:37:32 -08:00
Derrick Or 53428694a6 Separate Streams documentation and setup docs with easy to set variables
- Seperate Streams documentation out to a standalone page.
- Setup templates to use handlebars.js
- Create template variables to swap in frequently updated values like version number from a single file templateData.js

Author: Derrick Or <derrickor@gmail.com>

Reviewers: Guozhang Wang <wangguoz@gmail.com>

Closes #2245 from derrickdoo/docTemplates
2016-12-13 17:59:49 -08:00
Alex Loddengaard 6f0cbe7212 MINOR: doc fix related to monitoring consumer lag
Author: Alex Loddengaard <alexloddengaard@gmail.com>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #1814 from alexlod/consumer-lag-doc-fix
2016-11-29 09:57:22 -08:00
Ismael Juma 079ea89b36 KAFKA-4417: Update build dependencies for 0.10.2 cycle
Notes on the updates:
* Gradle to 3.2: better incremental build and faster IDE import times (https://docs.gradle.org/3.2/release-notes)
* zkclient to 0.10: it now uses slf4j-api instead of log4j
* zookeeper to 3.4.9: a few important bug fixes (http://zookeeper.apache.org/doc/r3.4.9/releasenotes.html)
* jackson to 2.8.5: lots of updates (https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.6, https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.7, https://github.com/FasterXML/jackson/wiki/Jackson-Release-2.8)
* jersey to 2.24: bug fixes (https://jersey.java.net/release-notes/2.23.html, https://jersey.java.net/release-notes/2.24.html)
* jopt to 5.0.3: minor improvements, the major version bump is due to requiring Java 7 instead of 6 (https://pholser.github.io/jopt-simple/changes.html)
* argparse4j to 0.7.0: minor tweaks and improvements (https://github.com/tatsuhiro-t/argparse4j/blob/argparse4j-0.6.0/NEWS, https://github.com/tatsuhiro-t/argparse4j/blob/argparse4j-0.7.0/NEWS)
* Gradle plugins
* bcpkix to 1.55: quite a few additions, but nothing that matters to us (http://www.bouncycastle.org/releasenotes.html)

Author: Ismael Juma <ismael@juma.me.uk>

Reviewers: Ewen Cheslack-Postava <ewen@confluent.io>

Closes #2144 from ijuma/gradle-3.2-and-deps
2016-11-17 14:43:00 -08:00
Ben Stopford b8cfa167ed DOC: Documentation for Throttled Replication
Author: Ben Stopford <benstopford@gmail.com>

Reviewers: Jun Rao, Gwen Shapira

Closes #2033 from benstopford/throttling-docs
2016-10-18 14:24:52 -07:00
Vahid Hashemian ae9532c6b3 MINOR: Fixed broken links in the documentation
Author: Vahid Hashemian <vahidhashemian@us.ibm.com>

Reviewers: Jason Gustafson <jason@confluent.io>

Closes #2010 from vahidhashemian/doc/fix_hyperlinks
2016-10-11 20:25:35 -07:00