forked from Blizzard/node-rdkafka
-
Notifications
You must be signed in to change notification settings - Fork 0
/
config.d.ts
1132 lines (955 loc) · 51.1 KB
/
config.d.ts
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
// ====== Generated from librdkafka 2.6.0 file CONFIGURATION.md ======
// Code that generated this is a derivative work of the code from Nam Nguyen
// https://gist.github.com/ntgn81/066c2c8ec5b4238f85d1e9168a04e3fb
export interface GlobalConfig {
/**
* Indicates the builtin features for this build of librdkafka. An application can either query this value or attempt to set it with its list of required features to check for library support.
*
* @default gzip, snappy, ssl, sasl, regex, lz4, sasl_gssapi, sasl_plain, sasl_scram, plugins, zstd, sasl_oauthbearer, http, oidc
*/
"builtin.features"?: string;
/**
* Client identifier.
*
* @default rdkafka
*/
"client.id"?: string;
/**
* Initial list of brokers as a CSV list of broker host or host:port. The application may also use `rd_kafka_brokers_add()` to add brokers during runtime.
*/
"metadata.broker.list"?: string;
/**
* Alias for `metadata.broker.list`: Initial list of brokers as a CSV list of broker host or host:port. The application may also use `rd_kafka_brokers_add()` to add brokers during runtime.
*/
"bootstrap.servers"?: string;
/**
* Maximum Kafka protocol request message size. Due to differing framing overhead between protocol versions the producer is unable to reliably enforce a strict max message limit at produce time and may exceed the maximum size by one message in protocol ProduceRequests, the broker will enforce the the topic's `max.message.bytes` limit (see Apache Kafka documentation).
*
* @default 1000000
*/
"message.max.bytes"?: number;
/**
* Maximum size for message to be copied to buffer. Messages larger than this will be passed by reference (zero-copy) at the expense of larger iovecs.
*
* @default 65535
*/
"message.copy.max.bytes"?: number;
/**
* Maximum Kafka protocol response message size. This serves as a safety precaution to avoid memory exhaustion in case of protocol hickups. This value must be at least `fetch.max.bytes` + 512 to allow for protocol overhead; the value is adjusted automatically unless the configuration property is explicitly set.
*
* @default 100000000
*/
"receive.message.max.bytes"?: number;
/**
* Maximum number of in-flight requests per broker connection. This is a generic property applied to all broker communication, however it is primarily relevant to produce requests. In particular, note that other mechanisms limit the number of outstanding consumer fetch request per broker to one.
*
* @default 1000000
*/
"max.in.flight.requests.per.connection"?: number;
/**
* Alias for `max.in.flight.requests.per.connection`: Maximum number of in-flight requests per broker connection. This is a generic property applied to all broker communication, however it is primarily relevant to produce requests. In particular, note that other mechanisms limit the number of outstanding consumer fetch request per broker to one.
*
* @default 1000000
*/
"max.in.flight"?: number;
/**
* Period of time in milliseconds at which topic and broker metadata is refreshed in order to proactively discover any new brokers, topics, partitions or partition leader changes. Use -1 to disable the intervalled refresh (not recommended). If there are no locally referenced topics (no topic objects created, no messages produced, no subscription or no assignment) then only the broker list will be refreshed every interval but no more often than every 10s.
*
* @default 300000
*/
"topic.metadata.refresh.interval.ms"?: number;
/**
* Metadata cache max age. Defaults to topic.metadata.refresh.interval.ms * 3
*
* @default 900000
*/
"metadata.max.age.ms"?: number;
/**
* When a topic loses its leader a new metadata request will be enqueued immediately and then with this initial interval, exponentially increasing upto `retry.backoff.max.ms`, until the topic metadata has been refreshed. If not set explicitly, it will be defaulted to `retry.backoff.ms`. This is used to recover quickly from transitioning leader brokers.
*
* @default 100
*/
"topic.metadata.refresh.fast.interval.ms"?: number;
/**
* **DEPRECATED** No longer used.
*
* @default 10
*/
"topic.metadata.refresh.fast.cnt"?: number;
/**
* Sparse metadata requests (consumes less network bandwidth)
*
* @default true
*/
"topic.metadata.refresh.sparse"?: boolean;
/**
* Apache Kafka topic creation is asynchronous and it takes some time for a new topic to propagate throughout the cluster to all brokers. If a client requests topic metadata after manual topic creation but before the topic has been fully propagated to the broker the client is requesting metadata from, the topic will seem to be non-existent and the client will mark the topic as such, failing queued produced messages with `ERR__UNKNOWN_TOPIC`. This setting delays marking a topic as non-existent until the configured propagation max time has passed. The maximum propagation time is calculated from the time the topic is first referenced in the client, e.g., on produce().
*
* @default 30000
*/
"topic.metadata.propagation.max.ms"?: number;
/**
* Topic blacklist, a comma-separated list of regular expressions for matching topic names that should be ignored in broker metadata information as if the topics did not exist.
*/
"topic.blacklist"?: any;
/**
* A comma-separated list of debug contexts to enable. Detailed Producer debugging: broker,topic,msg. Consumer: consumer,cgrp,topic,fetch
*/
"debug"?: string;
/**
* Default timeout for network requests. Producer: ProduceRequests will use the lesser value of `socket.timeout.ms` and remaining `message.timeout.ms` for the first message in the batch. Consumer: FetchRequests will use `fetch.wait.max.ms` + `socket.timeout.ms`. Admin: Admin requests will use `socket.timeout.ms` or explicitly set `rd_kafka_AdminOptions_set_operation_timeout()` value.
*
* @default 60000
*/
"socket.timeout.ms"?: number;
/**
* **DEPRECATED** No longer used.
*
* @default 1000
*/
"socket.blocking.max.ms"?: number;
/**
* Broker socket send buffer size. System default is used if 0.
*
* @default 0
*/
"socket.send.buffer.bytes"?: number;
/**
* Broker socket receive buffer size. System default is used if 0.
*
* @default 0
*/
"socket.receive.buffer.bytes"?: number;
/**
* Enable TCP keep-alives (SO_KEEPALIVE) on broker sockets
*
* @default false
*/
"socket.keepalive.enable"?: boolean;
/**
* Disable the Nagle algorithm (TCP_NODELAY) on broker sockets.
*
* @default false
*/
"socket.nagle.disable"?: boolean;
/**
* Disconnect from broker when this number of send failures (e.g., timed out requests) is reached. Disable with 0. WARNING: It is highly recommended to leave this setting at its default value of 1 to avoid the client and broker to become desynchronized in case of request timeouts. NOTE: The connection is automatically re-established.
*
* @default 1
*/
"socket.max.fails"?: number;
/**
* How long to cache the broker address resolving results (milliseconds).
*
* @default 1000
*/
"broker.address.ttl"?: number;
/**
* Allowed broker IP address families: any, v4, v6
*
* @default any
*/
"broker.address.family"?: 'any' | 'v4' | 'v6';
/**
* Maximum time allowed for broker connection setup (TCP connection setup as well SSL and SASL handshake). If the connection to the broker is not fully functional after this the connection will be closed and retried.
*
* @default 30000
*/
"socket.connection.setup.timeout.ms"?: number;
/**
* Close broker connections after the specified time of inactivity. Disable with 0. If this property is left at its default value some heuristics are performed to determine a suitable default value, this is currently limited to identifying brokers on Azure (see librdkafka issue #3109 for more info).
*
* @default 0
*/
"connections.max.idle.ms"?: number;
/**
* **DEPRECATED** No longer used. See `reconnect.backoff.ms` and `reconnect.backoff.max.ms`.
*
* @default 0
*/
"reconnect.backoff.jitter.ms"?: number;
/**
* The initial time to wait before reconnecting to a broker after the connection has been closed. The time is increased exponentially until `reconnect.backoff.max.ms` is reached. -25% to +50% jitter is applied to each reconnect backoff. A value of 0 disables the backoff and reconnects immediately.
*
* @default 100
*/
"reconnect.backoff.ms"?: number;
/**
* The maximum time to wait before reconnecting to a broker after the connection has been closed.
*
* @default 10000
*/
"reconnect.backoff.max.ms"?: number;
/**
* librdkafka statistics emit interval. The application also needs to register a stats callback using `rd_kafka_conf_set_stats_cb()`. The granularity is 1000ms. A value of 0 disables statistics.
*
* @default 0
*/
"statistics.interval.ms"?: number;
/**
* See `rd_kafka_conf_set_events()`
*
* @default 0
*/
"enabled_events"?: number;
/**
* Error callback (set with rd_kafka_conf_set_error_cb())
*/
"error_cb"?: any;
/**
* Throttle callback (set with rd_kafka_conf_set_throttle_cb())
*/
"throttle_cb"?: any;
/**
* Statistics callback (set with rd_kafka_conf_set_stats_cb())
*/
"stats_cb"?: any;
/**
* Log callback (set with rd_kafka_conf_set_log_cb())
*/
"log_cb"?: any;
/**
* Logging level (syslog(3) levels)
*
* @default 6
*/
"log_level"?: number;
/**
* Disable spontaneous log_cb from internal librdkafka threads, instead enqueue log messages on queue set with `rd_kafka_set_log_queue()` and serve log callbacks or events through the standard poll APIs. **NOTE**: Log messages will linger in a temporary queue until the log queue has been set.
*
* @default false
*/
"log.queue"?: boolean;
/**
* Print internal thread name in log messages (useful for debugging librdkafka internals)
*
* @default true
*/
"log.thread.name"?: boolean;
/**
* If enabled librdkafka will initialize the PRNG with srand(current_time.milliseconds) on the first invocation of rd_kafka_new() (required only if rand_r() is not available on your platform). If disabled the application must call srand() prior to calling rd_kafka_new().
*
* @default true
*/
"enable.random.seed"?: boolean;
/**
* Log broker disconnects. It might be useful to turn this off when interacting with 0.9 brokers with an aggressive `connections.max.idle.ms` value.
*
* @default true
*/
"log.connection.close"?: boolean;
/**
* Background queue event callback (set with rd_kafka_conf_set_background_event_cb())
*/
"background_event_cb"?: any;
/**
* Socket creation callback to provide race-free CLOEXEC
*/
"socket_cb"?: any;
/**
* Socket connect callback
*/
"connect_cb"?: any;
/**
* Socket close callback
*/
"closesocket_cb"?: any;
/**
* File open callback to provide race-free CLOEXEC
*/
"open_cb"?: any;
/**
* Address resolution callback (set with rd_kafka_conf_set_resolve_cb()).
*/
"resolve_cb"?: any;
/**
* Application opaque (set with rd_kafka_conf_set_opaque())
*/
"opaque"?: any;
/**
* Default topic configuration for automatically subscribed topics
*/
"default_topic_conf"?: any;
/**
* Signal that librdkafka will use to quickly terminate on rd_kafka_destroy(). If this signal is not set then there will be a delay before rd_kafka_wait_destroyed() returns true as internal threads are timing out their system calls. If this signal is set however the delay will be minimal. The application should mask this signal as an internal signal handler is installed.
*
* @default 0
*/
"internal.termination.signal"?: number;
/**
* Request broker's supported API versions to adjust functionality to available protocol features. If set to false, or the ApiVersionRequest fails, the fallback version `broker.version.fallback` will be used. **NOTE**: Depends on broker version >=0.10.0. If the request is not supported by (an older) broker the `broker.version.fallback` fallback is used.
*
* @default true
*/
"api.version.request"?: boolean;
/**
* Timeout for broker API version requests.
*
* @default 10000
*/
"api.version.request.timeout.ms"?: number;
/**
* Dictates how long the `broker.version.fallback` fallback is used in the case the ApiVersionRequest fails. **NOTE**: The ApiVersionRequest is only issued when a new connection to the broker is made (such as after an upgrade).
*
* @default 0
*/
"api.version.fallback.ms"?: number;
/**
* Older broker versions (before 0.10.0) provide no way for a client to query for supported protocol features (ApiVersionRequest, see `api.version.request`) making it impossible for the client to know what features it may use. As a workaround a user may set this property to the expected broker version and the client will automatically adjust its feature set accordingly if the ApiVersionRequest fails (or is disabled). The fallback broker version will be used for `api.version.fallback.ms`. Valid values are: 0.9.0, 0.8.2, 0.8.1, 0.8.0. Any other value >= 0.10, such as 0.10.2.1, enables ApiVersionRequests.
*
* @default 0.10.0
*/
"broker.version.fallback"?: string;
/**
* Allow automatic topic creation on the broker when subscribing to or assigning non-existent topics. The broker must also be configured with `auto.create.topics.enable=true` for this configuration to take effect. Note: the default value (true) for the producer is different from the default value (false) for the consumer. Further, the consumer default value is different from the Java consumer (true), and this property is not supported by the Java producer. Requires broker version >= 0.11.0.0, for older broker versions only the broker configuration applies.
*
* @default false
*/
"allow.auto.create.topics"?: boolean;
/**
* Protocol used to communicate with brokers.
*
* @default plaintext
*/
"security.protocol"?: 'plaintext' | 'ssl' | 'sasl_plaintext' | 'sasl_ssl';
/**
* A cipher suite is a named combination of authentication, encryption, MAC and key exchange algorithm used to negotiate the security settings for a network connection using TLS or SSL network protocol. See manual page for `ciphers(1)` and `SSL_CTX_set_cipher_list(3).
*/
"ssl.cipher.suites"?: string;
/**
* The supported-curves extension in the TLS ClientHello message specifies the curves (standard/named, or 'explicit' GF(2^k) or GF(p)) the client is willing to have the server use. See manual page for `SSL_CTX_set1_curves_list(3)`. OpenSSL >= 1.0.2 required.
*/
"ssl.curves.list"?: string;
/**
* The client uses the TLS ClientHello signature_algorithms extension to indicate to the server which signature/hash algorithm pairs may be used in digital signatures. See manual page for `SSL_CTX_set1_sigalgs_list(3)`. OpenSSL >= 1.0.2 required.
*/
"ssl.sigalgs.list"?: string;
/**
* Path to client's private key (PEM) used for authentication.
*/
"ssl.key.location"?: string;
/**
* Private key passphrase (for use with `ssl.key.location` and `set_ssl_cert()`)
*/
"ssl.key.password"?: string;
/**
* Client's private key string (PEM format) used for authentication.
*/
"ssl.key.pem"?: string;
/**
* Client's private key as set by rd_kafka_conf_set_ssl_cert()
*/
"ssl_key"?: any;
/**
* Path to client's public key (PEM) used for authentication.
*/
"ssl.certificate.location"?: string;
/**
* Client's public key string (PEM format) used for authentication.
*/
"ssl.certificate.pem"?: string;
/**
* Client's public key as set by rd_kafka_conf_set_ssl_cert()
*/
"ssl_certificate"?: any;
/**
* File or directory path to CA certificate(s) for verifying the broker's key. Defaults: On Windows the system's CA certificates are automatically looked up in the Windows Root certificate store. On Mac OSX this configuration defaults to `probe`. It is recommended to install openssl using Homebrew, to provide CA certificates. On Linux install the distribution's ca-certificates package. If OpenSSL is statically linked or `ssl.ca.location` is set to `probe` a list of standard paths will be probed and the first one found will be used as the default CA certificate location path. If OpenSSL is dynamically linked the OpenSSL library's default path will be used (see `OPENSSLDIR` in `openssl version -a`).
*/
"ssl.ca.location"?: string;
/**
* CA certificate string (PEM format) for verifying the broker's key.
*/
"ssl.ca.pem"?: string;
/**
* CA certificate as set by rd_kafka_conf_set_ssl_cert()
*/
"ssl_ca"?: any;
/**
* Comma-separated list of Windows Certificate stores to load CA certificates from. Certificates will be loaded in the same order as stores are specified. If no certificates can be loaded from any of the specified stores an error is logged and the OpenSSL library's default CA location is used instead. Store names are typically one or more of: MY, Root, Trust, CA.
*
* @default Root
*/
"ssl.ca.certificate.stores"?: string;
/**
* Path to CRL for verifying broker's certificate validity.
*/
"ssl.crl.location"?: string;
/**
* Path to client's keystore (PKCS#12) used for authentication.
*/
"ssl.keystore.location"?: string;
/**
* Client's keystore (PKCS#12) password.
*/
"ssl.keystore.password"?: string;
/**
* Comma-separated list of OpenSSL 3.0.x implementation providers. E.g., "default,legacy".
*/
"ssl.providers"?: string;
/**
* **DEPRECATED** Path to OpenSSL engine library. OpenSSL >= 1.1.x required. DEPRECATED: OpenSSL engine support is deprecated and should be replaced by OpenSSL 3 providers.
*/
"ssl.engine.location"?: string;
/**
* OpenSSL engine id is the name used for loading engine.
*
* @default dynamic
*/
"ssl.engine.id"?: string;
/**
* OpenSSL engine callback data (set with rd_kafka_conf_set_engine_callback_data()).
*/
"ssl_engine_callback_data"?: any;
/**
* Enable OpenSSL's builtin broker (server) certificate verification. This verification can be extended by the application by implementing a certificate_verify_cb.
*
* @default true
*/
"enable.ssl.certificate.verification"?: boolean;
/**
* Endpoint identification algorithm to validate broker hostname using broker certificate. https - Server (broker) hostname verification as specified in RFC2818. none - No endpoint verification. OpenSSL >= 1.0.2 required.
*
* @default https
*/
"ssl.endpoint.identification.algorithm"?: 'none' | 'https';
/**
* Callback to verify the broker certificate chain.
*/
"ssl.certificate.verify_cb"?: any;
/**
* SASL mechanism to use for authentication. Supported: GSSAPI, PLAIN, SCRAM-SHA-256, SCRAM-SHA-512, OAUTHBEARER. **NOTE**: Despite the name only one mechanism must be configured.
*
* @default GSSAPI
*/
"sasl.mechanisms"?: string;
/**
* Alias for `sasl.mechanisms`: SASL mechanism to use for authentication. Supported: GSSAPI, PLAIN, SCRAM-SHA-256, SCRAM-SHA-512, OAUTHBEARER. **NOTE**: Despite the name only one mechanism must be configured.
*
* @default GSSAPI
*/
"sasl.mechanism"?: string;
/**
* Kerberos principal name that Kafka runs as, not including /hostname@REALM
*
* @default kafka
*/
"sasl.kerberos.service.name"?: string;
/**
* This client's Kerberos principal name. (Not supported on Windows, will use the logon user's principal).
*
* @default kafkaclient
*/
"sasl.kerberos.principal"?: string;
/**
* kinit -t "%{sasl.kerberos.keytab}" -k %{sasl.kerberos.principal} | low | Shell command to refresh or acquire the client's Kerberos ticket. This command is executed on client creation and every sasl.kerberos.min.time.before.relogin (0=disable). %{config.prop.name} is replaced by corresponding config object value.
*
* @default kinit -R -t "%{sasl.kerberos.keytab}" -k %{sasl.kerberos.principal} \
*/
"sasl.kerberos.kinit.cmd"?: string;
/**
* Path to Kerberos keytab file. This configuration property is only used as a variable in `sasl.kerberos.kinit.cmd` as ` ... -t "%{sasl.kerberos.keytab}"`.
*/
"sasl.kerberos.keytab"?: string;
/**
* Minimum time in milliseconds between key refresh attempts. Disable automatic key refresh by setting this property to 0.
*
* @default 60000
*/
"sasl.kerberos.min.time.before.relogin"?: number;
/**
* SASL username for use with the PLAIN and SASL-SCRAM-.. mechanisms
*/
"sasl.username"?: string;
/**
* SASL password for use with the PLAIN and SASL-SCRAM-.. mechanism
*/
"sasl.password"?: string;
/**
* SASL/OAUTHBEARER configuration. The format is implementation-dependent and must be parsed accordingly. The default unsecured token implementation (see https://tools.ietf.org/html/rfc7515#appendix-A.5) recognizes space-separated name=value pairs with valid names including principalClaimName, principal, scopeClaimName, scope, and lifeSeconds. The default value for principalClaimName is "sub", the default value for scopeClaimName is "scope", and the default value for lifeSeconds is 3600. The scope value is CSV format with the default value being no/empty scope. For example: `principalClaimName=azp principal=admin scopeClaimName=roles scope=role1,role2 lifeSeconds=600`. In addition, SASL extensions can be communicated to the broker via `extension_NAME=value`. For example: `principal=admin extension_traceId=123`
*/
"sasl.oauthbearer.config"?: string;
/**
* Enable the builtin unsecure JWT OAUTHBEARER token handler if no oauthbearer_refresh_cb has been set. This builtin handler should only be used for development or testing, and not in production.
*
* @default false
*/
"enable.sasl.oauthbearer.unsecure.jwt"?: boolean;
/**
* SASL/OAUTHBEARER token refresh callback (set with rd_kafka_conf_set_oauthbearer_token_refresh_cb(), triggered by rd_kafka_poll(), et.al. This callback will be triggered when it is time to refresh the client's OAUTHBEARER token. Also see `rd_kafka_conf_enable_sasl_queue()`.
*/
"oauthbearer_token_refresh_cb"?: any;
/**
* Set to "default" or "oidc" to control which login method to be used. If set to "oidc", the following properties must also be be specified: `sasl.oauthbearer.client.id`, `sasl.oauthbearer.client.secret`, and `sasl.oauthbearer.token.endpoint.url`.
*
* @default default
*/
"sasl.oauthbearer.method"?: 'default' | 'oidc';
/**
* Public identifier for the application. Must be unique across all clients that the authorization server handles. Only used when `sasl.oauthbearer.method` is set to "oidc".
*/
"sasl.oauthbearer.client.id"?: string;
/**
* Client secret only known to the application and the authorization server. This should be a sufficiently random string that is not guessable. Only used when `sasl.oauthbearer.method` is set to "oidc".
*/
"sasl.oauthbearer.client.secret"?: string;
/**
* Client use this to specify the scope of the access request to the broker. Only used when `sasl.oauthbearer.method` is set to "oidc".
*/
"sasl.oauthbearer.scope"?: string;
/**
* Allow additional information to be provided to the broker. Comma-separated list of key=value pairs. E.g., "supportFeatureX=true,organizationId=sales-emea".Only used when `sasl.oauthbearer.method` is set to "oidc".
*/
"sasl.oauthbearer.extensions"?: string;
/**
* OAuth/OIDC issuer token endpoint HTTP(S) URI used to retrieve token. Only used when `sasl.oauthbearer.method` is set to "oidc".
*/
"sasl.oauthbearer.token.endpoint.url"?: string;
/**
* List of plugin libraries to load (; separated). The library search path is platform dependent (see dlopen(3) for Unix and LoadLibrary() for Windows). If no filename extension is specified the platform-specific extension (such as .dll or .so) will be appended automatically.
*/
"plugin.library.paths"?: string;
/**
* Interceptors added through rd_kafka_conf_interceptor_add_..() and any configuration handled by interceptors.
*/
"interceptors"?: any;
/**
* A rack identifier for this client. This can be any string value which indicates where this client is physically located. It corresponds with the broker config `broker.rack`.
*/
"client.rack"?: string;
/**
* The backoff time in milliseconds before retrying a protocol request, this is the first backoff time, and will be backed off exponentially until number of retries is exhausted, and it's capped by retry.backoff.max.ms.
*
* @default 100
*/
"retry.backoff.ms"?: number;
/**
* The max backoff time in milliseconds before retrying a protocol request, this is the atmost backoff allowed for exponentially backed off requests.
*
* @default 1000
*/
"retry.backoff.max.ms"?: number;
/**
* Controls how the client uses DNS lookups. By default, when the lookup returns multiple IP addresses for a hostname, they will all be attempted for connection before the connection is considered failed. This applies to both bootstrap and advertised servers. If the value is set to `resolve_canonical_bootstrap_servers_only`, each entry will be resolved and expanded into a list of canonical names. **WARNING**: `resolve_canonical_bootstrap_servers_only` must only be used with `GSSAPI` (Kerberos) as `sasl.mechanism`, as it's the only purpose of this configuration value. **NOTE**: Default here is different from the Java client's default behavior, which connects only to the first IP address returned for a hostname.
*
* @default use_all_dns_ips
*/
"client.dns.lookup"?: 'use_all_dns_ips' | 'resolve_canonical_bootstrap_servers_only';
/**
* Whether to enable pushing of client metrics to the cluster, if the cluster has a client metrics subscription which matches this client
*
* @default true
*/
"enable.metrics.push"?: boolean;
/**
* Enables or disables `event.*` emitting.
*
* @default true
*/
"event_cb"?: boolean;
}
export interface ProducerGlobalConfig extends GlobalConfig {
/**
* Enables the transactional producer. The transactional.id is used to identify the same transactional producer instance across process restarts. It allows the producer to guarantee that transactions corresponding to earlier instances of the same producer have been finalized prior to starting any new transactions, and that any zombie instances are fenced off. If no transactional.id is provided, then the producer is limited to idempotent delivery (if enable.idempotence is set). Requires broker version >= 0.11.0.
*/
"transactional.id"?: string;
/**
* The maximum amount of time in milliseconds that the transaction coordinator will wait for a transaction status update from the producer before proactively aborting the ongoing transaction. If this value is larger than the `transaction.max.timeout.ms` setting in the broker, the init_transactions() call will fail with ERR_INVALID_TRANSACTION_TIMEOUT. The transaction timeout automatically adjusts `message.timeout.ms` and `socket.timeout.ms`, unless explicitly configured in which case they must not exceed the transaction timeout (`socket.timeout.ms` must be at least 100ms lower than `transaction.timeout.ms`). This is also the default timeout value if no timeout (-1) is supplied to the transactional API methods.
*
* @default 60000
*/
"transaction.timeout.ms"?: number;
/**
* When set to `true`, the producer will ensure that messages are successfully produced exactly once and in the original produce order. The following configuration properties are adjusted automatically (if not modified by the user) when idempotence is enabled: `max.in.flight.requests.per.connection=5` (must be less than or equal to 5), `retries=INT32_MAX` (must be greater than 0), `acks=all`, `queuing.strategy=fifo`. Producer instantation will fail if user-supplied configuration is incompatible.
*
* @default false
*/
"enable.idempotence"?: boolean;
/**
* **EXPERIMENTAL**: subject to change or removal. When set to `true`, any error that could result in a gap in the produced message series when a batch of messages fails, will raise a fatal error (ERR__GAPLESS_GUARANTEE) and stop the producer. Messages failing due to `message.timeout.ms` are not covered by this guarantee. Requires `enable.idempotence=true`.
*
* @default false
*/
"enable.gapless.guarantee"?: boolean;
/**
* Maximum number of messages allowed on the producer queue. This queue is shared by all topics and partitions. A value of 0 disables this limit.
*
* @default 100000
*/
"queue.buffering.max.messages"?: number;
/**
* Maximum total message size sum allowed on the producer queue. This queue is shared by all topics and partitions. This property has higher priority than queue.buffering.max.messages.
*
* @default 1048576
*/
"queue.buffering.max.kbytes"?: number;
/**
* Delay in milliseconds to wait for messages in the producer queue to accumulate before constructing message batches (MessageSets) to transmit to brokers. A higher value allows larger and more effective (less overhead, improved compression) batches of messages to accumulate at the expense of increased message delivery latency.
*
* @default 5
*/
"queue.buffering.max.ms"?: any;
/**
* Alias for `queue.buffering.max.ms`: Delay in milliseconds to wait for messages in the producer queue to accumulate before constructing message batches (MessageSets) to transmit to brokers. A higher value allows larger and more effective (less overhead, improved compression) batches of messages to accumulate at the expense of increased message delivery latency.
*
* @default 5
*/
"linger.ms"?: any;
/**
* How many times to retry sending a failing Message. **Note:** retrying may cause reordering unless `enable.idempotence` is set to true.
*
* @default 2147483647
*/
"message.send.max.retries"?: number;
/**
* Alias for `message.send.max.retries`: How many times to retry sending a failing Message. **Note:** retrying may cause reordering unless `enable.idempotence` is set to true.
*
* @default 2147483647
*/
"retries"?: number;
/**
* The threshold of outstanding not yet transmitted broker requests needed to backpressure the producer's message accumulator. If the number of not yet transmitted requests equals or exceeds this number, produce request creation that would have otherwise been triggered (for example, in accordance with linger.ms) will be delayed. A lower number yields larger and more effective batches. A higher value can improve latency when using compression on slow machines.
*
* @default 1
*/
"queue.buffering.backpressure.threshold"?: number;
/**
* compression codec to use for compressing message sets. This is the default value for all topics, may be overridden by the topic configuration property `compression.codec`.
*
* @default none
*/
"compression.codec"?: 'none' | 'gzip' | 'snappy' | 'lz4' | 'zstd';
/**
* Alias for `compression.codec`: compression codec to use for compressing message sets. This is the default value for all topics, may be overridden by the topic configuration property `compression.codec`.
*
* @default none
*/
"compression.type"?: 'none' | 'gzip' | 'snappy' | 'lz4' | 'zstd';
/**
* Maximum number of messages batched in one MessageSet. The total MessageSet size is also limited by batch.size and message.max.bytes.
*
* @default 10000
*/
"batch.num.messages"?: number;
/**
* Maximum size (in bytes) of all messages batched in one MessageSet, including protocol framing overhead. This limit is applied after the first message has been added to the batch, regardless of the first message's size, this is to ensure that messages that exceed batch.size are produced. The total MessageSet size is also limited by batch.num.messages and message.max.bytes.
*
* @default 1000000
*/
"batch.size"?: number;
/**
* Only provide delivery reports for failed messages.
*
* @default false
*/
"delivery.report.only.error"?: boolean;
/**
* Delivery report callback (set with rd_kafka_conf_set_dr_cb())
*/
"dr_cb"?: boolean | Function;
/**
* Delivery report callback (set with rd_kafka_conf_set_dr_msg_cb())
*/
"dr_msg_cb"?: boolean;
/**
* Delay in milliseconds to wait to assign new sticky partitions for each topic. By default, set to double the time of linger.ms. To disable sticky behavior, set to 0. This behavior affects messages with the key NULL in all cases, and messages with key lengths of zero when the consistent_random partitioner is in use. These messages would otherwise be assigned randomly. A higher value allows for more effective batching of these messages.
*
* @default 10
*/
"sticky.partitioning.linger.ms"?: number;
}
export interface ConsumerGlobalConfig extends GlobalConfig {
/**
* Client group id string. All clients sharing the same group.id belong to the same group.
*/
"group.id"?: string;
/**
* Enable static group membership. Static group members are able to leave and rejoin a group within the configured `session.timeout.ms` without prompting a group rebalance. This should be used in combination with a larger `session.timeout.ms` to avoid group rebalances caused by transient unavailability (e.g. process restarts). Requires broker version >= 2.3.0.
*/
"group.instance.id"?: string;
/**
* The name of one or more partition assignment strategies. The elected group leader will use a strategy supported by all members of the group to assign partitions to group members. If there is more than one eligible strategy, preference is determined by the order of this list (strategies earlier in the list have higher priority). Cooperative and non-cooperative (eager) strategies must not be mixed. Available strategies: range, roundrobin, cooperative-sticky.
*
* @default range,roundrobin
*/
"partition.assignment.strategy"?: string;
/**
* Client group session and failure detection timeout. The consumer sends periodic heartbeats (heartbeat.interval.ms) to indicate its liveness to the broker. If no hearts are received by the broker for a group member within the session timeout, the broker will remove the consumer from the group and trigger a rebalance. The allowed range is configured with the **broker** configuration properties `group.min.session.timeout.ms` and `group.max.session.timeout.ms`. Also see `max.poll.interval.ms`.
*
* @default 45000
*/
"session.timeout.ms"?: number;
/**
* Group session keepalive heartbeat interval.
*
* @default 3000
*/
"heartbeat.interval.ms"?: number;
/**
* Group protocol type for the `classic` group protocol. NOTE: Currently, the only supported group protocol type is `consumer`.
*
* @default consumer
*/
"group.protocol.type"?: string;
/**
* Group protocol to use. Use `classic` for the original protocol and `consumer` for the new protocol introduced in KIP-848. Available protocols: classic or consumer. Default is `classic`, but will change to `consumer` in next releases.
*
* @default classic
*/
"group.protocol"?: 'classic' | 'consumer';
/**
* Server side assignor to use. Keep it null to make server select a suitable assignor for the group. Available assignors: uniform or range. Default is null
*/
"group.remote.assignor"?: string;
/**
* How often to query for the current client group coordinator. If the currently assigned coordinator is down the configured query interval will be divided by ten to more quickly recover in case of coordinator reassignment.
*
* @default 600000
*/
"coordinator.query.interval.ms"?: number;
/**
* Maximum allowed time between calls to consume messages (e.g., rd_kafka_consumer_poll()) for high-level consumers. If this interval is exceeded the consumer is considered failed and the group will rebalance in order to reassign the partitions to another consumer group member. Warning: Offset commits may be not possible at this point. Note: It is recommended to set `enable.auto.offset.store=false` for long-time processing applications and then explicitly store offsets (using offsets_store()) *after* message processing, to make sure offsets are not auto-committed prior to processing has finished. The interval is checked two times per second. See KIP-62 for more information.
*
* @default 300000
*/
"max.poll.interval.ms"?: number;
/**
* Automatically and periodically commit offsets in the background. Note: setting this to false does not prevent the consumer from fetching previously committed start offsets. To circumvent this behaviour set specific start offsets per partition in the call to assign().
*
* @default true
*/
"enable.auto.commit"?: boolean;
/**
* The frequency in milliseconds that the consumer offsets are committed (written) to offset storage. (0 = disable). This setting is used by the high-level consumer.
*
* @default 5000
*/
"auto.commit.interval.ms"?: number;
/**
* Automatically store offset of last message provided to application. The offset store is an in-memory store of the next offset to (auto-)commit for each partition.
*
* @default true
*/
"enable.auto.offset.store"?: boolean;
/**
* Minimum number of messages per topic+partition librdkafka tries to maintain in the local consumer queue.
*
* @default 100000
*/
"queued.min.messages"?: number;
/**
* Maximum number of kilobytes of queued pre-fetched messages in the local consumer queue. If using the high-level consumer this setting applies to the single consumer queue, regardless of the number of partitions. When using the legacy simple consumer or when separate partition queues are used this setting applies per partition. This value may be overshot by fetch.message.max.bytes. This property has higher priority than queued.min.messages.
*
* @default 65536
*/
"queued.max.messages.kbytes"?: number;
/**
* Maximum time the broker may wait to fill the Fetch response with fetch.min.bytes of messages.
*
* @default 500
*/
"fetch.wait.max.ms"?: number;
/**
* How long to postpone the next fetch request for a topic+partition in case the current fetch queue thresholds (queued.min.messages or queued.max.messages.kbytes) have been exceded. This property may need to be decreased if the queue thresholds are set low and the application is experiencing long (~1s) delays between messages. Low values may increase CPU utilization.
*
* @default 1000
*/
"fetch.queue.backoff.ms"?: number;
/**
* Initial maximum number of bytes per topic+partition to request when fetching messages from the broker. If the client encounters a message larger than this value it will gradually try to increase it until the entire message can be fetched.
*
* @default 1048576
*/
"fetch.message.max.bytes"?: number;
/**
* Alias for `fetch.message.max.bytes`: Initial maximum number of bytes per topic+partition to request when fetching messages from the broker. If the client encounters a message larger than this value it will gradually try to increase it until the entire message can be fetched.
*
* @default 1048576
*/
"max.partition.fetch.bytes"?: number;
/**
* Maximum amount of data the broker shall return for a Fetch request. Messages are fetched in batches by the consumer and if the first message batch in the first non-empty partition of the Fetch request is larger than this value, then the message batch will still be returned to ensure the consumer can make progress. The maximum message batch size accepted by the broker is defined via `message.max.bytes` (broker config) or `max.message.bytes` (broker topic config). `fetch.max.bytes` is automatically adjusted upwards to be at least `message.max.bytes` (consumer config).
*
* @default 52428800
*/
"fetch.max.bytes"?: number;
/**
* Minimum number of bytes the broker responds with. If fetch.wait.max.ms expires the accumulated data will be sent to the client regardless of this setting.
*
* @default 1
*/
"fetch.min.bytes"?: number;
/**
* How long to postpone the next fetch request for a topic+partition in case of a fetch error.
*
* @default 500
*/
"fetch.error.backoff.ms"?: number;
/**
* **DEPRECATED** Offset commit store method: 'file' - DEPRECATED: local file store (offset.store.path, et.al), 'broker' - broker commit store (requires Apache Kafka 0.8.2 or later on the broker).
*
* @default broker
*/
"offset.store.method"?: 'none' | 'file' | 'broker';
/**
* Controls how to read messages written transactionally: `read_committed` - only return transactional messages which have been committed. `read_uncommitted` - return all messages, even transactional messages which have been aborted.
*
* @default read_committed
*/
"isolation.level"?: 'read_uncommitted' | 'read_committed';
/**
* Message consume callback (set with rd_kafka_conf_set_consume_cb())
*/
"consume_cb"?: any;
/**
* Called after consumer group has been rebalanced (set with rd_kafka_conf_set_rebalance_cb())
*/
"rebalance_cb"?: boolean | Function;
/**
* Offset commit result propagation callback. (set with rd_kafka_conf_set_offset_commit_cb())
*/
"offset_commit_cb"?: boolean | Function;
/**
* Emit RD_KAFKA_RESP_ERR__PARTITION_EOF event whenever the consumer reaches the end of a partition.
*
* @default false
*/
"enable.partition.eof"?: boolean;
/**
* Verify CRC32 of consumed messages, ensuring no on-the-wire or on-disk corruption to the messages occurred. This check comes at slightly increased CPU usage.
*
* @default false
*/
"check.crcs"?: boolean;
}
export interface TopicConfig {
/**
* Application opaque (set with rd_kafka_topic_conf_set_opaque())
*/
"opaque"?: any;
}
export interface ProducerTopicConfig extends TopicConfig {
/**
* This field indicates the number of acknowledgements the leader broker must receive from ISR brokers before responding to the request: *0*=Broker does not send any response/ack to client, *-1* or *all*=Broker will block until message is committed by all in sync replicas (ISRs). If there are less than `min.insync.replicas` (broker configuration) in the ISR set the produce request will fail.
*
* @default -1
*/
"request.required.acks"?: number;
/**
* Alias for `request.required.acks`: This field indicates the number of acknowledgements the leader broker must receive from ISR brokers before responding to the request: *0*=Broker does not send any response/ack to client, *-1* or *all*=Broker will block until message is committed by all in sync replicas (ISRs). If there are less than `min.insync.replicas` (broker configuration) in the ISR set the produce request will fail.
*
* @default -1
*/
"acks"?: number;