From c0a8e1776613edaa0be8f15f2aac47d9b0b93d77 Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Wed, 18 Jul 2018 11:38:00 +0200 Subject: [PATCH 01/34] Fix breaking change in monitoring data (#7563) The prefix for the stats metrics was metrics but renamed to `stats` by accident as the name is now auto generated. This reverts this change. Closes https://github.com/elastic/beats/issues/7562 --- .../monitoring/report/elasticsearch/elasticsearch.go | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/libbeat/monitoring/report/elasticsearch/elasticsearch.go b/libbeat/monitoring/report/elasticsearch/elasticsearch.go index a29950ae6740..7c9357abdd77 100644 --- a/libbeat/monitoring/report/elasticsearch/elasticsearch.go +++ b/libbeat/monitoring/report/elasticsearch/elasticsearch.go @@ -198,11 +198,12 @@ func (r *reporter) initLoop(c config) { logp.Info("Successfully connected to X-Pack Monitoring endpoint.") // Start collector and send loop if monitoring endpoint has been found. - go r.snapshotLoop("state", c.StatePeriod) - go r.snapshotLoop("stats", c.MetricsPeriod) + go r.snapshotLoop("state", "state", c.StatePeriod) + // For backward compatibility stats is named to metrics. + go r.snapshotLoop("stats", "metrics", c.MetricsPeriod) } -func (r *reporter) snapshotLoop(namespace string, period time.Duration) { +func (r *reporter) snapshotLoop(namespace, prefix string, period time.Duration) { ticker := time.NewTicker(period) defer ticker.Stop() @@ -225,8 +226,8 @@ func (r *reporter) snapshotLoop(namespace string, period time.Duration) { } fields := common.MapStr{ - "beat": r.beatMeta, - namespace: snapshot, + "beat": r.beatMeta, + prefix: snapshot, } if len(r.tags) > 0 { fields["tags"] = r.tags From 5eaf0b61dbee98d563e22eb7fd456948bf1adc0d Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Wed, 18 Jul 2018 11:47:31 +0200 Subject: [PATCH 02/34] Add http.request.mehod to Kibana log filset (#7607) Take `http.request.method` from ECS and apply it to the Kibana fileset. Additional logs are added to the example log files. --- filebeat/_meta/fields.common.yml | 4 ++ filebeat/docs/fields.asciidoc | 10 +++++ filebeat/include/fields.go | 2 +- .../module/kibana/log/ingest/pipeline.json | 7 ++++ filebeat/module/kibana/log/test/test.log | 2 + .../kibana/log/test/test.log-expected.json | 40 ++++++++++++++++++- 6 files changed, 63 insertions(+), 2 deletions(-) diff --git a/filebeat/_meta/fields.common.yml b/filebeat/_meta/fields.common.yml index 1c88011590aa..b3714b7579b2 100644 --- a/filebeat/_meta/fields.common.yml +++ b/filebeat/_meta/fields.common.yml @@ -131,3 +131,7 @@ description: > Content length of the HTTP response body. + - name: http.request.method + type: keyword + description: > + Request method. diff --git a/filebeat/docs/fields.asciidoc b/filebeat/docs/fields.asciidoc index 338463e443b3..615b55be10fb 100644 --- a/filebeat/docs/fields.asciidoc +++ b/filebeat/docs/fields.asciidoc @@ -2651,6 +2651,16 @@ type: long Content length of the HTTP response body. +-- + +*`http.request.method`*:: ++ +-- +type: keyword + +Request method. + + -- [[exported-fields-logstash]] diff --git a/filebeat/include/fields.go b/filebeat/include/fields.go index 93a1d10da3eb..50090ec4e8d1 100644 --- a/filebeat/include/fields.go +++ b/filebeat/include/fields.go @@ -31,5 +31,5 @@ func init() { // Asset returns asset data func Asset() string { - return "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" + return "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" } diff --git a/filebeat/module/kibana/log/ingest/pipeline.json b/filebeat/module/kibana/log/ingest/pipeline.json index 1eeb814fadb2..2e4d42814a82 100755 --- a/filebeat/module/kibana/log/ingest/pipeline.json +++ b/filebeat/module/kibana/log/ingest/pipeline.json @@ -67,6 +67,13 @@ "ignore_missing": true } }, + { + "rename": { + "field": "kibana.log.meta.req.method", + "target_field": "http.request.method", + "ignore_missing": true + } + }, { "date": { "field": "read_timestamp", diff --git a/filebeat/module/kibana/log/test/test.log b/filebeat/module/kibana/log/test/test.log index 8a01c4833020..a760016620e0 100644 --- a/filebeat/module/kibana/log/test/test.log +++ b/filebeat/module/kibana/log/test/test.log @@ -1 +1,3 @@ {"type":"response","@timestamp":"2018-05-09T10:57:55Z","tags":[],"pid":69410,"method":"get","statusCode":304,"req":{"url":"/ui/fonts/open_sans/open_sans_v15_latin_600.woff2","method":"get","headers":{"host":"localhost:5601","connection":"keep-alive","origin":"http://localhost:5601","user-agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.139 Safari/537.36","accept":"*/*","referer":"http://localhost:5601/app/kibana","accept-encoding":"gzip, deflate, br","accept-language":"en-US,en;q=0.9,de;q=0.8","if-none-match":"\"24234c1c81b3948758c1a0be8e5a65386ca94c52\"","if-modified-since":"Thu, 03 May 2018 09:45:28 GMT"},"remoteAddress":"127.0.0.1","userAgent":"127.0.0.1","referer":"http://localhost:5601/app/kibana"},"res":{"statusCode":304,"responseTime":26,"contentLength":9},"message":"GET /ui/fonts/open_sans/open_sans_v15_latin_600.woff2 304 26ms - 9.0B"} +{"type":"log","@timestamp":"2018-05-09T10:59:12Z","tags":["debug","monitoring-ui","kibana-monitoring"],"pid":69776,"message":"Fetching data from kibana_stats collector"} +{"type":"log","@timestamp":"2018-05-09T10:59:12Z","tags":["reporting","debug","exportTypes"],"pid":69776,"message":"Found exportType at /Users/ruflin/Downloads/6.3/kibana-6.3.0-darwin-x86_64/node_modules/x-pack/plugins/reporting/export_types/csv/server/index.js"} diff --git a/filebeat/module/kibana/log/test/test.log-expected.json b/filebeat/module/kibana/log/test/test.log-expected.json index 560c9982b240..614014610225 100644 --- a/filebeat/module/kibana/log/test/test.log-expected.json +++ b/filebeat/module/kibana/log/test/test.log-expected.json @@ -3,6 +3,7 @@ "@timestamp": "2018-05-09T10:57:55.000Z", "fileset.module": "kibana", "fileset.name": "log", + "http.request.method": "get", "http.response.content_length": 9, "http.response.elapsed_time": 26, "http.response.status_code": 304, @@ -18,7 +19,6 @@ "kibana.log.meta.req.headers.origin": "http://localhost:5601", "kibana.log.meta.req.headers.referer": "http://localhost:5601/app/kibana", "kibana.log.meta.req.headers.user-agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_13_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/66.0.3359.139 Safari/537.36", - "kibana.log.meta.req.method": "get", "kibana.log.meta.req.referer": "http://localhost:5601/app/kibana", "kibana.log.meta.req.remoteAddress": "127.0.0.1", "kibana.log.meta.req.url": "/ui/fonts/open_sans/open_sans_v15_latin_600.woff2", @@ -33,5 +33,43 @@ "service.name": [ "kibana" ] + }, + { + "@timestamp": "2018-05-09T10:59:12.000Z", + "fileset.module": "kibana", + "fileset.name": "log", + "input.type": "log", + "kibana.log.meta.type": "log", + "kibana.log.tags": [ + "debug", + "monitoring-ui", + "kibana-monitoring" + ], + "message": "Fetching data from kibana_stats collector", + "offset": 920, + "process.pid": 69776, + "prospector.type": "log", + "service.name": [ + "kibana" + ] + }, + { + "@timestamp": "2018-05-09T10:59:12.000Z", + "fileset.module": "kibana", + "fileset.name": "log", + "input.type": "log", + "kibana.log.meta.type": "log", + "kibana.log.tags": [ + "reporting", + "debug", + "exportTypes" + ], + "message": "Found exportType at /Users/ruflin/Downloads/6.3/kibana-6.3.0-darwin-x86_64/node_modules/x-pack/plugins/reporting/export_types/csv/server/index.js", + "offset": 1090, + "process.pid": 69776, + "prospector.type": "log", + "service.name": [ + "kibana" + ] } ] \ No newline at end of file From 3a0ab988b2623c6cedd3f67f61ca6d8fb73d63ec Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Wed, 18 Jul 2018 11:50:02 +0200 Subject: [PATCH 03/34] Fix rename log message (#7614) Instead of the from field the to field was logged. --- libbeat/processors/actions/rename.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/libbeat/processors/actions/rename.go b/libbeat/processors/actions/rename.go index bae1bd753f4a..47e367b9b5f3 100644 --- a/libbeat/processors/actions/rename.go +++ b/libbeat/processors/actions/rename.go @@ -100,7 +100,7 @@ func (f *renameFields) renameField(from string, to string, fields common.MapStr) if f.config.IgnoreMissing && errors.Cause(err) == common.ErrKeyNotFound { return nil } - return fmt.Errorf("could not fetch value for key: %s, Error: %s", to, err) + return fmt.Errorf("could not fetch value for key: %s, Error: %s", from, err) } // Deletion must happen first to support cases where a becomes a.b From 02bc2d497fbc31d69b6ac2638f6a7f546fd3a015 Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Wed, 18 Jul 2018 12:19:48 +0200 Subject: [PATCH 04/34] Add tests to verify template content (#7606) We recently started to move fields.yml into the Golang binary to be used internally. To make sure the loading important and loading of all the data into the binary works as expected for Metricbeat, this adds some basic tests. Related to https://github.com/elastic/beats/pull/7605. --- metricbeat/tests/system/test_template.py | 55 ++++++++++++++++++++++++ 1 file changed, 55 insertions(+) create mode 100644 metricbeat/tests/system/test_template.py diff --git a/metricbeat/tests/system/test_template.py b/metricbeat/tests/system/test_template.py new file mode 100644 index 000000000000..8766ba54ddf5 --- /dev/null +++ b/metricbeat/tests/system/test_template.py @@ -0,0 +1,55 @@ +import os +import metricbeat +import json +from nose.plugins.skip import SkipTest + + +class Test(metricbeat.BaseTest): + + def test_export_template(self): + """ + Test export template works and contains all fields + """ + + if os.name == "nt": + raise SkipTest + + self.render_config_template("metricbeat", + os.path.join(self.working_dir, + "metricbeat.yml"), + ) + + # Remove fields.yml to make sure template is built from internal binary data + os.remove(os.path.join(self.working_dir, "fields.yml")) + + exit_code = self.run_beat( + logging_args=[], + extra_args=["export", "template"], + config="metricbeat.yml", + output="template.json" + ) + assert exit_code == 0 + + template_path = os.path.join(self.working_dir, "template.json") + template_content = "" + + # Read in all json lines and discard the coverage info + with open(template_path) as f: + for line in f: + template_content += line + if line.startswith("}"): + break + + t = json.loads(template_content) + + properties = t["mappings"]["doc"]["properties"] + + # Check libbeat fields + assert properties["@timestamp"] == {"type": "date"} + assert properties["host"]["properties"]["name"] == {"type": "keyword", "ignore_above": 1024} + + # Check metricbeat generic field + assert properties["metricset"]["properties"]["host"] == {"type": "keyword", "ignore_above": 1024} + + # Check module specific field + assert properties["system"]["properties"]["cpu"]["properties"]["cores"] == {"type": "long"} From 731081b5ad6632381294d91d2703ad1a8a52dcc7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Pawe=C5=82=20Krze=C5=9Bniak?= Date: Wed, 18 Jul 2018 13:46:37 +0200 Subject: [PATCH 05/34] Basic support of ES GC metrics for jvm9 (#7628) GC log format for JVM9 is more detailed than for JVM8. Differences and possible improvements: * To get cpu_times.* a corellation between log lines is required. * Some GC metrics are available in jvm8 are not in jvm9 (class_unload_time_sec, weak_refs_processing_time_sec, ...) * heap.used_kb is empty, but it can be calculated as young_gen.used_kb + old_gen.size_kb * GC phase times are logged in miliseconds vs seconds in jvm8 --- .../elasticsearch/gc/ingest/pipeline.json | 4 +- .../module/elasticsearch/gc/test/gc.log.00 | 845 ++++++++++++++++++ 2 files changed, 848 insertions(+), 1 deletion(-) create mode 100644 filebeat/module/elasticsearch/gc/test/gc.log.00 diff --git a/filebeat/module/elasticsearch/gc/ingest/pipeline.json b/filebeat/module/elasticsearch/gc/ingest/pipeline.json index 6644ccf7a02b..9cdea8d5e347 100644 --- a/filebeat/module/elasticsearch/gc/ingest/pipeline.json +++ b/filebeat/module/elasticsearch/gc/ingest/pipeline.json @@ -8,6 +8,8 @@ "(?:%{JVM8HEADER}|%{JVM9HEADER}) Total time for which application threads were stopped: %{BASE10NUM:elasticsearch.gc.threads_total_stop_time_sec} seconds, Stopping threads took: %{BASE10NUM:elasticsearch.gc.stopping_threads_time_sec} seconds", "(?:%{JVM8HEADER}) \\[GC \\(%{DATA:elasticsearch.gc.phase.name}\\) \\[YG occupancy: %{BASE10NUM:elasticsearch.gc.young_gen.used_kb} K \\(%{BASE10NUM:elasticsearch.gc.young_gen.size_kb} K\\)\\]%{BASE10NUM}: \\[Rescan \\(parallel\\) , %{BASE10NUM:elasticsearch.gc.phase.parallel_rescan_time_sec} secs\\]%{BASE10NUM}: \\[weak refs processing, %{BASE10NUM:elasticsearch.gc.phase.weak_refs_processing_time_sec} secs\\]%{BASE10NUM}: \\[class unloading, %{BASE10NUM:elasticsearch.gc.phase.class_unload_time_sec} secs\\]%{BASE10NUM}: \\[scrub symbol table, %{BASE10NUM:elasticsearch.gc.phase.scrub_symbol_table_time_sec} secs\\]%{BASE10NUM}: \\[scrub string table, %{BASE10NUM:elasticsearch.gc.phase.scrub_string_table_time_sec} secs\\]\\[1 CMS-remark: %{BASE10NUM:elasticsearch.gc.old_gen.used_kb}K\\(%{BASE10NUM:elasticsearch.gc.old_gen.size_kb}K\\)\\] %{BASE10NUM:elasticsearch.gc.heap.used_kb}K\\(%{BASE10NUM:elasticsearch.gc.heap.size_kb}K\\), %{BASE10NUM:elasticsearch.gc.phase.duration_sec} secs\\] %{PROCTIME}", "(?:%{JVM8HEADER}) \\[GC \\(%{DATA:elasticsearch.gc.phase.name}\\) \\[%{BASE10NUM} CMS-initial-mark: %{BASE10NUM:elasticsearch.gc.old_gen.used_kb}K\\(%{BASE10NUM:elasticsearch.gc.old_gen.size_kb}K\\)\\] %{BASE10NUM:elasticsearch.gc.heap.used_kb}K\\(%{BASE10NUM:elasticsearch.gc.heap.size_kb}K\\), %{BASE10NUM:elasticsearch.gc.phase.duration_sec} secs\\] %{PROCTIME}", + "%{JVM9HEADER} GC\\(%{BASE10NUM}\\) ParNew: %{BASE10NUM}K-\\>%{BASE10NUM:elasticsearch.gc.young_gen.used_kb}K\\(%{BASE10NUM:elasticsearch.gc.young_gen.size_kb}K\\)", + "%{JVM9HEADER} GC\\(%{BASE10NUM}\\) Old: %{BASE10NUM}K-\\>%{BASE10NUM:elasticsearch.gc.old_gen.used_kb}K\\(%{BASE10NUM:elasticsearch.gc.old_gen.size_kb}K\\)", "(?:%{JVM8HEADER}|%{JVM9HEADER}) %{GREEDYMULTILINE:message}" ], "pattern_definitions": { @@ -54,4 +56,4 @@ } } ] -} \ No newline at end of file +} diff --git a/filebeat/module/elasticsearch/gc/test/gc.log.00 b/filebeat/module/elasticsearch/gc/test/gc.log.00 new file mode 100644 index 000000000000..d02f8cd57c4d --- /dev/null +++ b/filebeat/module/elasticsearch/gc/test/gc.log.00 @@ -0,0 +1,845 @@ +[2018-06-14T08:51:34.931+0000][16362][gc] Using Concurrent Mark Sweep +[2018-06-14T08:51:34.931+0000][16362][gc,heap,coops] Heap address: 0x00000000c0000000, size: 1024 MB, Compressed Oops mode: 32-bit +[2018-06-14T08:51:34.997+0000][16362][safepoint ] Application time: 0,0013776 seconds +[2018-06-14T08:51:34.997+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000465 seconds, Stopping threads took: 0,0000081 seconds +[2018-06-14T08:51:35.083+0000][16362][safepoint ] Application time: 0,0857120 seconds +[2018-06-14T08:51:35.083+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000613 seconds, Stopping threads took: 0,0000083 seconds +[2018-06-14T08:51:35.108+0000][16362][safepoint ] Application time: 0,0251701 seconds +[2018-06-14T08:51:35.108+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000544 seconds, Stopping threads took: 0,0000090 seconds +[2018-06-14T08:51:35.178+0000][16362][safepoint ] Application time: 0,0695913 seconds +[2018-06-14T08:51:35.178+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001067 seconds, Stopping threads took: 0,0000312 seconds +[2018-06-14T08:51:35.281+0000][16362][safepoint ] Application time: 0,1030248 seconds +[2018-06-14T08:51:35.281+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001140 seconds, Stopping threads took: 0,0000117 seconds +[2018-06-14T08:51:35.323+0000][16362][safepoint ] Application time: 0,0420679 seconds +[2018-06-14T08:51:35.323+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001653 seconds, Stopping threads took: 0,0000280 seconds +[2018-06-14T08:51:35.668+0000][16362][safepoint ] Application time: 0,3447341 seconds +[2018-06-14T08:51:35.668+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001630 seconds, Stopping threads took: 0,0000186 seconds +[2018-06-14T08:51:35.694+0000][16362][safepoint ] Application time: 0,0259603 seconds +[2018-06-14T08:51:35.694+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001532 seconds, Stopping threads took: 0,0000110 seconds +[2018-06-14T08:51:35.718+0000][16362][safepoint ] Application time: 0,0234962 seconds +[2018-06-14T08:51:35.718+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001549 seconds, Stopping threads took: 0,0000105 seconds +[2018-06-14T08:51:35.935+0000][16362][safepoint ] Application time: 0,2165754 seconds +[2018-06-14T08:51:35.935+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002723 seconds, Stopping threads took: 0,0000469 seconds +[2018-06-14T08:51:35.960+0000][16362][safepoint ] Application time: 0,0249139 seconds +[2018-06-14T08:51:35.960+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002749 seconds, Stopping threads took: 0,0000222 seconds +[2018-06-14T08:51:35.961+0000][16362][safepoint ] Application time: 0,0005559 seconds +[2018-06-14T08:51:35.961+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001305 seconds, Stopping threads took: 0,0000139 seconds +[2018-06-14T08:51:36.023+0000][16362][safepoint ] Application time: 0,0620753 seconds +[2018-06-14T08:51:36.023+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002743 seconds, Stopping threads took: 0,0000737 seconds +[2018-06-14T08:51:36.080+0000][16362][safepoint ] Application time: 0,0564153 seconds +[2018-06-14T08:51:36.080+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002067 seconds, Stopping threads took: 0,0000429 seconds +[2018-06-14T08:51:36.095+0000][16362][safepoint ] Application time: 0,0148334 seconds +[2018-06-14T08:51:36.095+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001947 seconds, Stopping threads took: 0,0000221 seconds +[2018-06-14T08:51:36.153+0000][16362][safepoint ] Application time: 0,0578379 seconds +[2018-06-14T08:51:36.153+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001668 seconds, Stopping threads took: 0,0000403 seconds +[2018-06-14T08:51:36.298+0000][16362][safepoint ] Application time: 0,1454838 seconds +[2018-06-14T08:51:36.299+0000][16362][gc,start ] GC(0) Pause Young (Allocation Failure) +[2018-06-14T08:51:36.299+0000][16362][gc,task ] GC(0) Using 8 workers of 8 for evacuation +[2018-06-14T08:51:36.317+0000][16362][gc,age ] GC(0) Desired survivor size 17891328 bytes, new threshold 1 (max threshold 6) +[2018-06-14T08:51:36.317+0000][16362][gc,age ] GC(0) Age table with threshold 1 (max threshold 6) +[2018-06-14T08:51:36.317+0000][16362][gc,age ] GC(0) - age 1: 22876888 bytes, 22876888 total +[2018-06-14T08:51:36.317+0000][16362][gc,heap ] GC(0) ParNew: 279616K->22442K(314560K) +[2018-06-14T08:51:36.317+0000][16362][gc,heap ] GC(0) CMS: 0K->0K(699072K) +[2018-06-14T08:51:36.317+0000][16362][gc,metaspace ] GC(0) Metaspace: 22102K->22102K(1069056K) +[2018-06-14T08:51:36.317+0000][16362][gc ] GC(0) Pause Young (Allocation Failure) 273M->21M(989M) 18,081ms +[2018-06-14T08:51:36.317+0000][16362][gc,cpu ] GC(0) User=0,07s Sys=0,00s Real=0,02s +[2018-06-14T08:51:36.317+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0182581 seconds, Stopping threads took: 0,0000382 seconds +[2018-06-14T08:51:36.317+0000][16362][safepoint ] Application time: 0,0000929 seconds +[2018-06-14T08:51:36.317+0000][16362][gc,start ] GC(1) Pause Initial Mark +[2018-06-14T08:51:36.322+0000][16362][gc ] GC(1) Pause Initial Mark 27M->27M(989M) 4,584ms +[2018-06-14T08:51:36.322+0000][16362][gc,cpu ] GC(1) User=0,01s Sys=0,00s Real=0,00s +[2018-06-14T08:51:36.322+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0047200 seconds, Stopping threads took: 0,0000424 seconds +[2018-06-14T08:51:36.322+0000][16362][gc ] GC(1) Concurrent Mark +[2018-06-14T08:51:36.322+0000][16362][gc,task ] GC(1) Using 2 workers of 2 for marking +[2018-06-14T08:51:36.322+0000][16362][gc ] GC(1) Concurrent Mark 0,448ms +[2018-06-14T08:51:36.322+0000][16362][gc,cpu ] GC(1) User=0,00s Sys=0,00s Real=0,00s +[2018-06-14T08:51:36.322+0000][16362][gc ] GC(1) Concurrent Preclean +[2018-06-14T08:51:36.324+0000][16362][gc ] GC(1) Concurrent Preclean 1,930ms +[2018-06-14T08:51:36.324+0000][16362][gc,cpu ] GC(1) User=0,01s Sys=0,00s Real=0,01s +[2018-06-14T08:51:36.324+0000][16362][gc ] GC(1) Concurrent Abortable Preclean +[2018-06-14T08:51:36.330+0000][16362][safepoint ] Application time: 0,0086761 seconds +[2018-06-14T08:51:36.330+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001865 seconds, Stopping threads took: 0,0000211 seconds +[2018-06-14T08:51:36.341+0000][16362][safepoint ] Application time: 0,0108866 seconds +[2018-06-14T08:51:36.342+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002705 seconds, Stopping threads took: 0,0000223 seconds +[2018-06-14T08:51:36.345+0000][16362][safepoint ] Application time: 0,0034809 seconds +[2018-06-14T08:51:36.345+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001782 seconds, Stopping threads took: 0,0000203 seconds +[2018-06-14T08:51:36.351+0000][16362][safepoint ] Application time: 0,0054978 seconds +[2018-06-14T08:51:36.351+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002228 seconds, Stopping threads took: 0,0000189 seconds +[2018-06-14T08:51:36.357+0000][16362][safepoint ] Application time: 0,0061981 seconds +[2018-06-14T08:51:36.358+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001449 seconds, Stopping threads took: 0,0000177 seconds +[2018-06-14T08:51:36.358+0000][16362][safepoint ] Application time: 0,0008906 seconds +[2018-06-14T08:51:36.359+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002331 seconds, Stopping threads took: 0,0000142 seconds +[2018-06-14T08:51:36.400+0000][16362][safepoint ] Application time: 0,0408569 seconds +[2018-06-14T08:51:36.400+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001782 seconds, Stopping threads took: 0,0000195 seconds +[2018-06-14T08:51:36.402+0000][16362][safepoint ] Application time: 0,0018498 seconds +[2018-06-14T08:51:36.402+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000736 seconds, Stopping threads took: 0,0000437 seconds +[2018-06-14T08:51:36.454+0000][16362][safepoint ] Application time: 0,0523837 seconds +[2018-06-14T08:51:36.454+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002349 seconds, Stopping threads took: 0,0000234 seconds +[2018-06-14T08:51:36.481+0000][16362][safepoint ] Application time: 0,0267564 seconds +[2018-06-14T08:51:36.481+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001691 seconds, Stopping threads took: 0,0000204 seconds +[2018-06-14T08:51:36.588+0000][16362][safepoint ] Application time: 0,1063695 seconds +[2018-06-14T08:51:36.588+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001962 seconds, Stopping threads took: 0,0000219 seconds +[2018-06-14T08:51:36.639+0000][16362][safepoint ] Application time: 0,0508469 seconds +[2018-06-14T08:51:36.639+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001402 seconds, Stopping threads took: 0,0000237 seconds +[2018-06-14T08:51:36.677+0000][16362][safepoint ] Application time: 0,0384305 seconds +[2018-06-14T08:51:36.678+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001639 seconds, Stopping threads took: 0,0000193 seconds +[2018-06-14T08:51:36.721+0000][16362][safepoint ] Application time: 0,0435383 seconds +[2018-06-14T08:51:36.721+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001489 seconds, Stopping threads took: 0,0000186 seconds +[2018-06-14T08:51:36.739+0000][16362][safepoint ] Application time: 0,0173663 seconds +[2018-06-14T08:51:36.739+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001924 seconds, Stopping threads took: 0,0000285 seconds +[2018-06-14T08:51:36.749+0000][16362][safepoint ] Application time: 0,0104712 seconds +[2018-06-14T08:51:36.750+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001681 seconds, Stopping threads took: 0,0000170 seconds +[2018-06-14T08:51:36.869+0000][16362][safepoint ] Application time: 0,1197164 seconds +[2018-06-14T08:51:36.870+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002316 seconds, Stopping threads took: 0,0000227 seconds +[2018-06-14T08:51:36.895+0000][16362][safepoint ] Application time: 0,0252741 seconds +[2018-06-14T08:51:36.895+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001727 seconds, Stopping threads took: 0,0000243 seconds +[2018-06-14T08:51:36.984+0000][16362][safepoint ] Application time: 0,0890138 seconds +[2018-06-14T08:51:36.984+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001581 seconds, Stopping threads took: 0,0000390 seconds +[2018-06-14T08:51:36.984+0000][16362][gc ] GC(1) Concurrent Abortable Preclean 660,217ms +[2018-06-14T08:51:36.984+0000][16362][gc,cpu ] GC(1) User=2,79s Sys=0,01s Real=0,66s +[2018-06-14T08:51:36.984+0000][16362][safepoint ] Application time: 0,0000632 seconds +[2018-06-14T08:51:36.984+0000][16362][gc,start ] GC(1) Pause Remark +[2018-06-14T08:51:37.021+0000][16362][gc ] GC(1) Pause Remark 235M->235M(989M) 36,981ms +[2018-06-14T08:51:37.021+0000][16362][gc,cpu ] GC(1) User=0,22s Sys=0,00s Real=0,03s +[2018-06-14T08:51:37.021+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0371064 seconds, Stopping threads took: 0,0000366 seconds +[2018-06-14T08:51:37.022+0000][16362][gc ] GC(1) Concurrent Sweep +[2018-06-14T08:51:37.022+0000][16362][gc ] GC(1) Concurrent Sweep 0,034ms +[2018-06-14T08:51:37.022+0000][16362][gc,cpu ] GC(1) User=0,00s Sys=0,00s Real=0,00s +[2018-06-14T08:51:37.022+0000][16362][gc ] GC(1) Concurrent Reset +[2018-06-14T08:51:37.022+0000][16362][gc ] GC(1) Concurrent Reset 0,617ms +[2018-06-14T08:51:37.022+0000][16362][gc,cpu ] GC(1) User=0,01s Sys=0,00s Real=0,00s +[2018-06-14T08:51:37.022+0000][16362][gc,heap ] GC(1) Old: 0K->0K(699072K) +[2018-06-14T08:51:37.071+0000][16362][safepoint ] Application time: 0,0494728 seconds +[2018-06-14T08:51:37.071+0000][16362][gc,start ] GC(2) Pause Young (Allocation Failure) +[2018-06-14T08:51:37.071+0000][16362][gc,task ] GC(2) Using 8 workers of 8 for evacuation +[2018-06-14T08:51:37.116+0000][16362][gc,age ] GC(2) Desired survivor size 17891328 bytes, new threshold 1 (max threshold 6) +[2018-06-14T08:51:37.116+0000][16362][gc,age ] GC(2) Age table with threshold 1 (max threshold 6) +[2018-06-14T08:51:37.116+0000][16362][gc,age ] GC(2) - age 1: 23032120 bytes, 23032120 total +[2018-06-14T08:51:37.116+0000][16362][gc,heap ] GC(2) ParNew: 302058K->25355K(314560K) +[2018-06-14T08:51:37.116+0000][16362][gc,heap ] GC(2) CMS: 0K->8029K(699072K) +[2018-06-14T08:51:37.116+0000][16362][gc,metaspace ] GC(2) Metaspace: 26661K->26661K(1075200K) +[2018-06-14T08:51:37.116+0000][16362][gc ] GC(2) Pause Young (Allocation Failure) 294M->32M(989M) 44,557ms +[2018-06-14T08:51:37.116+0000][16362][gc,cpu ] GC(2) User=0,19s Sys=0,00s Real=0,05s +[2018-06-14T08:51:37.116+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0447119 seconds, Stopping threads took: 0,0000213 seconds +[2018-06-14T08:51:37.367+0000][16362][safepoint ] Application time: 0,2513078 seconds +[2018-06-14T08:51:37.367+0000][16362][gc,start ] GC(3) Pause Young (Allocation Failure) +[2018-06-14T08:51:37.367+0000][16362][gc,task ] GC(3) Using 8 workers of 8 for evacuation +[2018-06-14T08:51:37.389+0000][16362][gc,age ] GC(3) Desired survivor size 17891328 bytes, new threshold 1 (max threshold 6) +[2018-06-14T08:51:37.389+0000][16362][gc,age ] GC(3) Age table with threshold 1 (max threshold 6) +[2018-06-14T08:51:37.389+0000][16362][gc,age ] GC(3) - age 1: 18651576 bytes, 18651576 total +[2018-06-14T08:51:37.389+0000][16362][gc,heap ] GC(3) ParNew: 304971K->19887K(314560K) +[2018-06-14T08:51:37.389+0000][16362][gc,heap ] GC(3) CMS: 8029K->13651K(699072K) +[2018-06-14T08:51:37.389+0000][16362][gc,metaspace ] GC(3) Metaspace: 27395K->27395K(1075200K) +[2018-06-14T08:51:37.389+0000][16362][gc ] GC(3) Pause Young (Allocation Failure) 305M->32M(989M) 21,652ms +[2018-06-14T08:51:37.389+0000][16362][gc,cpu ] GC(3) User=0,09s Sys=0,00s Real=0,02s +[2018-06-14T08:51:37.389+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0217930 seconds, Stopping threads took: 0,0000241 seconds +[2018-06-14T08:51:37.613+0000][16362][safepoint ] Application time: 0,2240724 seconds +[2018-06-14T08:51:37.613+0000][16362][gc,start ] GC(4) Pause Young (Allocation Failure) +[2018-06-14T08:51:37.613+0000][16362][gc,task ] GC(4) Using 8 workers of 8 for evacuation +[2018-06-14T08:51:37.642+0000][16362][gc,age ] GC(4) Desired survivor size 17891328 bytes, new threshold 1 (max threshold 6) +[2018-06-14T08:51:37.642+0000][16362][gc,age ] GC(4) Age table with threshold 1 (max threshold 6) +[2018-06-14T08:51:37.642+0000][16362][gc,age ] GC(4) - age 1: 21544568 bytes, 21544568 total +[2018-06-14T08:51:37.642+0000][16362][gc,heap ] GC(4) ParNew: 299503K->24138K(314560K) +[2018-06-14T08:51:37.642+0000][16362][gc,heap ] GC(4) CMS: 13651K->17147K(699072K) +[2018-06-14T08:51:37.642+0000][16362][gc,metaspace ] GC(4) Metaspace: 28070K->28070K(1075200K) +[2018-06-14T08:51:37.642+0000][16362][gc ] GC(4) Pause Young (Allocation Failure) 305M->40M(989M) 28,936ms +[2018-06-14T08:51:37.642+0000][16362][gc,cpu ] GC(4) User=0,09s Sys=0,00s Real=0,02s +[2018-06-14T08:51:37.642+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0290959 seconds, Stopping threads took: 0,0000244 seconds +[2018-06-14T08:51:37.760+0000][16362][safepoint ] Application time: 0,1182362 seconds +[2018-06-14T08:51:37.761+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004286 seconds, Stopping threads took: 0,0000210 seconds +[2018-06-14T08:51:38.243+0000][16362][safepoint ] Application time: 0,4824845 seconds +[2018-06-14T08:51:38.244+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004303 seconds, Stopping threads took: 0,0000247 seconds +[2018-06-14T08:51:38.308+0000][16362][safepoint ] Application time: 0,0645735 seconds +[2018-06-14T08:51:38.309+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0005214 seconds, Stopping threads took: 0,0000356 seconds +[2018-06-14T08:51:38.951+0000][16362][safepoint ] Application time: 0,6425351 seconds +[2018-06-14T08:51:38.952+0000][16362][gc,start ] GC(5) Pause Young (Allocation Failure) +[2018-06-14T08:51:38.952+0000][16362][gc,task ] GC(5) Using 8 workers of 8 for evacuation +[2018-06-14T08:51:38.984+0000][16362][gc,age ] GC(5) Desired survivor size 17891328 bytes, new threshold 1 (max threshold 6) +[2018-06-14T08:51:38.984+0000][16362][gc,age ] GC(5) Age table with threshold 1 (max threshold 6) +[2018-06-14T08:51:38.984+0000][16362][gc,age ] GC(5) - age 1: 24694288 bytes, 24694288 total +[2018-06-14T08:51:38.984+0000][16362][gc,heap ] GC(5) ParNew: 303754K->24961K(314560K) +[2018-06-14T08:51:38.984+0000][16362][gc,heap ] GC(5) CMS: 17147K->17582K(699072K) +[2018-06-14T08:51:38.984+0000][16362][gc,metaspace ] GC(5) Metaspace: 34503K->34503K(1081344K) +[2018-06-14T08:51:38.984+0000][16362][gc ] GC(5) Pause Young (Allocation Failure) 313M->41M(989M) 32,461ms +[2018-06-14T08:51:38.984+0000][16362][gc,cpu ] GC(5) User=0,18s Sys=0,00s Real=0,04s +[2018-06-14T08:51:38.984+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0326552 seconds, Stopping threads took: 0,0000258 seconds +[2018-06-14T08:51:39.001+0000][16362][safepoint ] Application time: 0,0173506 seconds +[2018-06-14T08:51:39.002+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0005243 seconds, Stopping threads took: 0,0000425 seconds +[2018-06-14T08:51:39.332+0000][16362][safepoint ] Application time: 0,3303608 seconds +[2018-06-14T08:51:39.333+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001153 seconds, Stopping threads took: 0,0000235 seconds +[2018-06-14T08:51:39.358+0000][16362][safepoint ] Application time: 0,0251687 seconds +[2018-06-14T08:51:39.358+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004354 seconds, Stopping threads took: 0,0000806 seconds +[2018-06-14T08:51:39.372+0000][16362][safepoint ] Application time: 0,0138182 seconds +[2018-06-14T08:51:39.372+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000789 seconds, Stopping threads took: 0,0000381 seconds +[2018-06-14T08:51:39.462+0000][16362][safepoint ] Application time: 0,0896554 seconds +[2018-06-14T08:51:39.462+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000729 seconds, Stopping threads took: 0,0000200 seconds +[2018-06-14T08:51:39.729+0000][16362][safepoint ] Application time: 0,2668070 seconds +[2018-06-14T08:51:39.729+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002930 seconds, Stopping threads took: 0,0000217 seconds +[2018-06-14T08:51:39.749+0000][16362][safepoint ] Application time: 0,0198484 seconds +[2018-06-14T08:51:39.749+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001315 seconds, Stopping threads took: 0,0000194 seconds +[2018-06-14T08:51:39.772+0000][16362][safepoint ] Application time: 0,0230753 seconds +[2018-06-14T08:51:39.772+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001172 seconds, Stopping threads took: 0,0000163 seconds +[2018-06-14T08:51:39.796+0000][16362][safepoint ] Application time: 0,0236529 seconds +[2018-06-14T08:51:39.796+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001824 seconds, Stopping threads took: 0,0000204 seconds +[2018-06-14T08:51:39.821+0000][16362][safepoint ] Application time: 0,0246474 seconds +[2018-06-14T08:51:39.821+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001550 seconds, Stopping threads took: 0,0000165 seconds +[2018-06-14T08:51:39.839+0000][16362][safepoint ] Application time: 0,0181780 seconds +[2018-06-14T08:51:39.839+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001717 seconds, Stopping threads took: 0,0000206 seconds +[2018-06-14T08:51:39.853+0000][16362][safepoint ] Application time: 0,0136168 seconds +[2018-06-14T08:51:39.853+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001737 seconds, Stopping threads took: 0,0000206 seconds +[2018-06-14T08:51:39.868+0000][16362][safepoint ] Application time: 0,0147586 seconds +[2018-06-14T08:51:39.868+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001435 seconds, Stopping threads took: 0,0000341 seconds +[2018-06-14T08:51:39.888+0000][16362][safepoint ] Application time: 0,0200703 seconds +[2018-06-14T08:51:39.888+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001522 seconds, Stopping threads took: 0,0000381 seconds +[2018-06-14T08:51:39.904+0000][16362][safepoint ] Application time: 0,0159442 seconds +[2018-06-14T08:51:39.905+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001951 seconds, Stopping threads took: 0,0000237 seconds +[2018-06-14T08:51:39.921+0000][16362][safepoint ] Application time: 0,0163132 seconds +[2018-06-14T08:51:39.921+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001396 seconds, Stopping threads took: 0,0000164 seconds +[2018-06-14T08:51:39.942+0000][16362][safepoint ] Application time: 0,0209721 seconds +[2018-06-14T08:51:39.942+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001416 seconds, Stopping threads took: 0,0000165 seconds +[2018-06-14T08:51:39.960+0000][16362][safepoint ] Application time: 0,0177758 seconds +[2018-06-14T08:51:39.960+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001360 seconds, Stopping threads took: 0,0000141 seconds +[2018-06-14T08:51:40.130+0000][16362][safepoint ] Application time: 0,1697866 seconds +[2018-06-14T08:51:40.130+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001661 seconds, Stopping threads took: 0,0000213 seconds +[2018-06-14T08:51:40.220+0000][16362][safepoint ] Application time: 0,0900979 seconds +[2018-06-14T08:51:40.220+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001691 seconds, Stopping threads took: 0,0000199 seconds +[2018-06-14T08:51:40.306+0000][16362][safepoint ] Application time: 0,0854200 seconds +[2018-06-14T08:51:40.306+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001878 seconds, Stopping threads took: 0,0000277 seconds +[2018-06-14T08:51:40.335+0000][16362][safepoint ] Application time: 0,0290283 seconds +[2018-06-14T08:51:40.335+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001392 seconds, Stopping threads took: 0,0000200 seconds +[2018-06-14T08:51:40.355+0000][16362][safepoint ] Application time: 0,0196613 seconds +[2018-06-14T08:51:40.355+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001411 seconds, Stopping threads took: 0,0000213 seconds +[2018-06-14T08:51:40.376+0000][16362][safepoint ] Application time: 0,0208562 seconds +[2018-06-14T08:51:40.376+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001798 seconds, Stopping threads took: 0,0000198 seconds +[2018-06-14T08:51:40.389+0000][16362][safepoint ] Application time: 0,0122574 seconds +[2018-06-14T08:51:40.389+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000904 seconds, Stopping threads took: 0,0000323 seconds +[2018-06-14T08:51:40.418+0000][16362][safepoint ] Application time: 0,0295200 seconds +[2018-06-14T08:51:40.418+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001534 seconds, Stopping threads took: 0,0000267 seconds +[2018-06-14T08:51:40.441+0000][16362][safepoint ] Application time: 0,0221963 seconds +[2018-06-14T08:51:40.441+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001097 seconds, Stopping threads took: 0,0000179 seconds +[2018-06-14T08:51:40.463+0000][16362][safepoint ] Application time: 0,0221172 seconds +[2018-06-14T08:51:40.463+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001408 seconds, Stopping threads took: 0,0000194 seconds +[2018-06-14T08:51:40.491+0000][16362][safepoint ] Application time: 0,0280564 seconds +[2018-06-14T08:51:40.491+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001989 seconds, Stopping threads took: 0,0000378 seconds +[2018-06-14T08:51:40.513+0000][16362][safepoint ] Application time: 0,0214317 seconds +[2018-06-14T08:51:40.513+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001698 seconds, Stopping threads took: 0,0000307 seconds +[2018-06-14T08:51:40.559+0000][16362][safepoint ] Application time: 0,0460948 seconds +[2018-06-14T08:51:40.559+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002047 seconds, Stopping threads took: 0,0000261 seconds +[2018-06-14T08:51:40.561+0000][16362][safepoint ] Application time: 0,0019543 seconds +[2018-06-14T08:51:40.561+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001334 seconds, Stopping threads took: 0,0000855 seconds +[2018-06-14T08:51:40.564+0000][16362][safepoint ] Application time: 0,0024272 seconds +[2018-06-14T08:51:40.564+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000928 seconds, Stopping threads took: 0,0000372 seconds +[2018-06-14T08:51:40.565+0000][16362][safepoint ] Application time: 0,0009413 seconds +[2018-06-14T08:51:40.565+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001162 seconds, Stopping threads took: 0,0000449 seconds +[2018-06-14T08:51:40.566+0000][16362][safepoint ] Application time: 0,0012354 seconds +[2018-06-14T08:51:40.566+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001834 seconds, Stopping threads took: 0,0001322 seconds +[2018-06-14T08:51:40.581+0000][16362][safepoint ] Application time: 0,0144779 seconds +[2018-06-14T08:51:40.581+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001120 seconds, Stopping threads took: 0,0000182 seconds +[2018-06-14T08:51:40.624+0000][16362][safepoint ] Application time: 0,0431552 seconds +[2018-06-14T08:51:40.624+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001829 seconds, Stopping threads took: 0,0000325 seconds +[2018-06-14T08:51:40.644+0000][16362][safepoint ] Application time: 0,0196341 seconds +[2018-06-14T08:51:40.644+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001109 seconds, Stopping threads took: 0,0000181 seconds +[2018-06-14T08:51:40.667+0000][16362][safepoint ] Application time: 0,0230741 seconds +[2018-06-14T08:51:40.667+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000543 seconds, Stopping threads took: 0,0000252 seconds +[2018-06-14T08:51:40.679+0000][16362][safepoint ] Application time: 0,0120256 seconds +[2018-06-14T08:51:40.680+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001767 seconds, Stopping threads took: 0,0000194 seconds +[2018-06-14T08:51:40.705+0000][16362][safepoint ] Application time: 0,0257074 seconds +[2018-06-14T08:51:40.706+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001215 seconds, Stopping threads took: 0,0000224 seconds +[2018-06-14T08:51:40.724+0000][16362][safepoint ] Application time: 0,0182948 seconds +[2018-06-14T08:51:40.724+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001463 seconds, Stopping threads took: 0,0000181 seconds +[2018-06-14T08:51:40.742+0000][16362][safepoint ] Application time: 0,0177480 seconds +[2018-06-14T08:51:40.742+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000829 seconds, Stopping threads took: 0,0000195 seconds +[2018-06-14T08:51:40.758+0000][16362][safepoint ] Application time: 0,0159158 seconds +[2018-06-14T08:51:40.758+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001753 seconds, Stopping threads took: 0,0000223 seconds +[2018-06-14T08:51:40.768+0000][16362][safepoint ] Application time: 0,0100798 seconds +[2018-06-14T08:51:40.768+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001751 seconds, Stopping threads took: 0,0000206 seconds +[2018-06-14T08:51:40.804+0000][16362][safepoint ] Application time: 0,0355588 seconds +[2018-06-14T08:51:40.804+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000868 seconds, Stopping threads took: 0,0000392 seconds +[2018-06-14T08:51:40.804+0000][16362][safepoint ] Application time: 0,0000732 seconds +[2018-06-14T08:51:40.804+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000409 seconds, Stopping threads took: 0,0000139 seconds +[2018-06-14T08:51:40.808+0000][16362][safepoint ] Application time: 0,0034044 seconds +[2018-06-14T08:51:40.808+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002149 seconds, Stopping threads took: 0,0000269 seconds +[2018-06-14T08:51:40.817+0000][16362][safepoint ] Application time: 0,0096844 seconds +[2018-06-14T08:51:40.818+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000424 seconds, Stopping threads took: 0,0000193 seconds +[2018-06-14T08:51:40.838+0000][16362][safepoint ] Application time: 0,0200936 seconds +[2018-06-14T08:51:40.838+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001458 seconds, Stopping threads took: 0,0000185 seconds +[2018-06-14T08:51:40.873+0000][16362][safepoint ] Application time: 0,0352531 seconds +[2018-06-14T08:51:40.873+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001120 seconds, Stopping threads took: 0,0000198 seconds +[2018-06-14T08:51:40.894+0000][16362][safepoint ] Application time: 0,0208565 seconds +[2018-06-14T08:51:40.894+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000946 seconds, Stopping threads took: 0,0000395 seconds +[2018-06-14T08:51:40.901+0000][16362][safepoint ] Application time: 0,0063649 seconds +[2018-06-14T08:51:40.901+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001979 seconds, Stopping threads took: 0,0000205 seconds +[2018-06-14T08:51:40.935+0000][16362][safepoint ] Application time: 0,0341098 seconds +[2018-06-14T08:51:40.935+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001404 seconds, Stopping threads took: 0,0000213 seconds +[2018-06-14T08:51:40.957+0000][16362][safepoint ] Application time: 0,0216910 seconds +[2018-06-14T08:51:40.957+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001834 seconds, Stopping threads took: 0,0000200 seconds +[2018-06-14T08:51:40.975+0000][16362][safepoint ] Application time: 0,0175447 seconds +[2018-06-14T08:51:40.975+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0005813 seconds, Stopping threads took: 0,0004210 seconds +[2018-06-14T08:51:40.983+0000][16362][safepoint ] Application time: 0,0081661 seconds +[2018-06-14T08:51:40.990+0000][16362][gc,start ] GC(6) Pause Initial Mark +[2018-06-14T08:51:41.020+0000][16362][gc ] GC(6) Pause Initial Mark 301M->301M(989M) 30,521ms +[2018-06-14T08:51:41.020+0000][16362][gc,cpu ] GC(6) User=0,19s Sys=0,00s Real=0,03s +[2018-06-14T08:51:41.020+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0306529 seconds, Stopping threads took: 0,0000343 seconds +[2018-06-14T08:51:41.020+0000][16362][gc ] GC(6) Concurrent Mark +[2018-06-14T08:51:41.020+0000][16362][gc,task ] GC(6) Using 2 workers of 2 for marking +[2018-06-14T08:51:41.021+0000][16362][safepoint ] Application time: 0,0006964 seconds +[2018-06-14T08:51:41.021+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001800 seconds, Stopping threads took: 0,0000325 seconds +[2018-06-14T08:51:41.034+0000][16362][gc ] GC(6) Concurrent Mark 13,494ms +[2018-06-14T08:51:41.034+0000][16362][gc,cpu ] GC(6) User=0,07s Sys=0,00s Real=0,02s +[2018-06-14T08:51:41.034+0000][16362][gc ] GC(6) Concurrent Preclean +[2018-06-14T08:51:41.038+0000][16362][gc ] GC(6) Concurrent Preclean 4,138ms +[2018-06-14T08:51:41.038+0000][16362][gc,cpu ] GC(6) User=0,02s Sys=0,00s Real=0,00s +[2018-06-14T08:51:41.038+0000][16362][gc ] GC(6) Concurrent Abortable Preclean +[2018-06-14T08:51:41.073+0000][16362][safepoint ] Application time: 0,0521271 seconds +[2018-06-14T08:51:41.074+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002408 seconds, Stopping threads took: 0,0000251 seconds +[2018-06-14T08:51:41.104+0000][16362][safepoint ] Application time: 0,0302355 seconds +[2018-06-14T08:51:41.104+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001814 seconds, Stopping threads took: 0,0000219 seconds +[2018-06-14T08:51:41.104+0000][16362][safepoint ] Application time: 0,0000393 seconds +[2018-06-14T08:51:41.104+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000335 seconds, Stopping threads took: 0,0000144 seconds +[2018-06-14T08:51:41.130+0000][16362][safepoint ] Application time: 0,0260363 seconds +[2018-06-14T08:51:41.130+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001562 seconds, Stopping threads took: 0,0000227 seconds +[2018-06-14T08:51:41.150+0000][16362][safepoint ] Application time: 0,0196948 seconds +[2018-06-14T08:51:41.150+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001832 seconds, Stopping threads took: 0,0000207 seconds +[2018-06-14T08:51:41.174+0000][16362][safepoint ] Application time: 0,0239209 seconds +[2018-06-14T08:51:41.174+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001450 seconds, Stopping threads took: 0,0000282 seconds +[2018-06-14T08:51:41.198+0000][16362][safepoint ] Application time: 0,0235092 seconds +[2018-06-14T08:51:41.198+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001949 seconds, Stopping threads took: 0,0000246 seconds +[2018-06-14T08:51:41.231+0000][16362][safepoint ] Application time: 0,0333107 seconds +[2018-06-14T08:51:41.232+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002201 seconds, Stopping threads took: 0,0000240 seconds +[2018-06-14T08:51:41.246+0000][16362][safepoint ] Application time: 0,0138114 seconds +[2018-06-14T08:51:41.246+0000][16362][gc,start ] GC(7) Pause Young (Allocation Failure) +[2018-06-14T08:51:41.246+0000][16362][gc,task ] GC(7) Using 8 workers of 8 for evacuation +[2018-06-14T08:51:41.294+0000][16362][gc,age ] GC(7) Desired survivor size 17891328 bytes, new threshold 1 (max threshold 6) +[2018-06-14T08:51:41.294+0000][16362][gc,age ] GC(7) Age table with threshold 1 (max threshold 6) +[2018-06-14T08:51:41.294+0000][16362][gc,age ] GC(7) - age 1: 30789256 bytes, 30789256 total +[2018-06-14T08:51:41.294+0000][16362][gc,heap ] GC(7) ParNew: 304577K->34943K(314560K) +[2018-06-14T08:51:41.294+0000][16362][gc,heap ] GC(7) CMS: 17582K->35638K(699072K) +[2018-06-14T08:51:41.294+0000][16362][gc,metaspace ] GC(7) Metaspace: 57556K->57556K(1103872K) +[2018-06-14T08:51:41.294+0000][16362][gc ] GC(7) Pause Young (Allocation Failure) 314M->68M(989M) 48,106ms +[2018-06-14T08:51:41.294+0000][16362][gc,cpu ] GC(7) User=0,28s Sys=0,00s Real=0,05s +[2018-06-14T08:51:41.294+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0482527 seconds, Stopping threads took: 0,0000325 seconds +[2018-06-14T08:51:41.297+0000][16362][safepoint ] Application time: 0,0028884 seconds +[2018-06-14T08:51:41.297+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0003468 seconds, Stopping threads took: 0,0002594 seconds +[2018-06-14T08:51:41.297+0000][16362][safepoint ] Application time: 0,0000341 seconds +[2018-06-14T08:51:41.297+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001227 seconds, Stopping threads took: 0,0000779 seconds +[2018-06-14T08:51:41.297+0000][16362][safepoint ] Application time: 0,0000346 seconds +[2018-06-14T08:51:41.297+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000522 seconds, Stopping threads took: 0,0000248 seconds +[2018-06-14T08:51:41.297+0000][16362][safepoint ] Application time: 0,0000223 seconds +[2018-06-14T08:51:41.297+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000472 seconds, Stopping threads took: 0,0000239 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Application time: 0,0000187 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000507 seconds, Stopping threads took: 0,0000181 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Application time: 0,0000212 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000895 seconds, Stopping threads took: 0,0000296 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Application time: 0,0000225 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000711 seconds, Stopping threads took: 0,0000210 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Application time: 0,0000305 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000527 seconds, Stopping threads took: 0,0000132 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Application time: 0,0000203 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000488 seconds, Stopping threads took: 0,0000122 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Application time: 0,0000177 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000511 seconds, Stopping threads took: 0,0000156 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Application time: 0,0000193 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002620 seconds, Stopping threads took: 0,0002181 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Application time: 0,0000276 seconds +[2018-06-14T08:51:41.298+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000439 seconds, Stopping threads took: 0,0000153 seconds +[2018-06-14T08:51:41.299+0000][16362][safepoint ] Application time: 0,0000183 seconds +[2018-06-14T08:51:41.299+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000466 seconds, Stopping threads took: 0,0000235 seconds +[2018-06-14T08:51:41.300+0000][16362][safepoint ] Application time: 0,0011576 seconds +[2018-06-14T08:51:41.300+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000817 seconds, Stopping threads took: 0,0000302 seconds +[2018-06-14T08:51:41.300+0000][16362][safepoint ] Application time: 0,0000933 seconds +[2018-06-14T08:51:41.300+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000579 seconds, Stopping threads took: 0,0000140 seconds +[2018-06-14T08:51:41.300+0000][16362][safepoint ] Application time: 0,0000232 seconds +[2018-06-14T08:51:41.300+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004030 seconds, Stopping threads took: 0,0003601 seconds +[2018-06-14T08:51:41.301+0000][16362][safepoint ] Application time: 0,0000304 seconds +[2018-06-14T08:51:41.301+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000479 seconds, Stopping threads took: 0,0000210 seconds +[2018-06-14T08:51:41.304+0000][16362][safepoint ] Application time: 0,0031690 seconds +[2018-06-14T08:51:41.304+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000877 seconds, Stopping threads took: 0,0000229 seconds +[2018-06-14T08:51:41.304+0000][16362][safepoint ] Application time: 0,0000268 seconds +[2018-06-14T08:51:41.304+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000636 seconds, Stopping threads took: 0,0000131 seconds +[2018-06-14T08:51:41.304+0000][16362][safepoint ] Application time: 0,0000265 seconds +[2018-06-14T08:51:41.304+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000877 seconds, Stopping threads took: 0,0000125 seconds +[2018-06-14T08:51:41.315+0000][16362][safepoint ] Application time: 0,0110828 seconds +[2018-06-14T08:51:41.315+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002298 seconds, Stopping threads took: 0,0000297 seconds +[2018-06-14T08:51:41.321+0000][16362][safepoint ] Application time: 0,0057527 seconds +[2018-06-14T08:51:41.321+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000591 seconds, Stopping threads took: 0,0000252 seconds +[2018-06-14T08:51:41.353+0000][16362][safepoint ] Application time: 0,0319928 seconds +[2018-06-14T08:51:41.354+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001807 seconds, Stopping threads took: 0,0000237 seconds +[2018-06-14T08:51:41.383+0000][16362][safepoint ] Application time: 0,0292158 seconds +[2018-06-14T08:51:41.383+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002646 seconds, Stopping threads took: 0,0000254 seconds +[2018-06-14T08:51:41.416+0000][16362][safepoint ] Application time: 0,0329888 seconds +[2018-06-14T08:51:41.416+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001979 seconds, Stopping threads took: 0,0000246 seconds +[2018-06-14T08:51:41.436+0000][16362][safepoint ] Application time: 0,0194050 seconds +[2018-06-14T08:51:41.436+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001073 seconds, Stopping threads took: 0,0000275 seconds +[2018-06-14T08:51:41.441+0000][16362][safepoint ] Application time: 0,0050149 seconds +[2018-06-14T08:51:41.441+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001270 seconds, Stopping threads took: 0,0000678 seconds +[2018-06-14T08:51:41.441+0000][16362][safepoint ] Application time: 0,0001475 seconds +[2018-06-14T08:51:41.441+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000718 seconds, Stopping threads took: 0,0000275 seconds +[2018-06-14T08:51:41.444+0000][16362][safepoint ] Application time: 0,0030078 seconds +[2018-06-14T08:51:41.444+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001249 seconds, Stopping threads took: 0,0000772 seconds +[2018-06-14T08:51:41.471+0000][16362][safepoint ] Application time: 0,0267534 seconds +[2018-06-14T08:51:41.471+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001762 seconds, Stopping threads took: 0,0000384 seconds +[2018-06-14T08:51:41.507+0000][16362][safepoint ] Application time: 0,0354683 seconds +[2018-06-14T08:51:41.507+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001912 seconds, Stopping threads took: 0,0000277 seconds +[2018-06-14T08:51:41.533+0000][16362][safepoint ] Application time: 0,0255760 seconds +[2018-06-14T08:51:41.533+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001632 seconds, Stopping threads took: 0,0000219 seconds +[2018-06-14T08:51:41.605+0000][16362][safepoint ] Application time: 0,0716369 seconds +[2018-06-14T08:51:41.605+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004029 seconds, Stopping threads took: 0,0000206 seconds +[2018-06-14T08:51:41.614+0000][16362][safepoint ] Application time: 0,0085563 seconds +[2018-06-14T08:51:41.614+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001602 seconds, Stopping threads took: 0,0000204 seconds +[2018-06-14T08:51:41.649+0000][16362][safepoint ] Application time: 0,0350231 seconds +[2018-06-14T08:51:41.649+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001476 seconds, Stopping threads took: 0,0000189 seconds +[2018-06-14T08:51:41.672+0000][16362][safepoint ] Application time: 0,0226100 seconds +[2018-06-14T08:51:41.672+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001494 seconds, Stopping threads took: 0,0000186 seconds +[2018-06-14T08:51:41.723+0000][16362][safepoint ] Application time: 0,0516548 seconds +[2018-06-14T08:51:41.724+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001575 seconds, Stopping threads took: 0,0000283 seconds +[2018-06-14T08:51:41.783+0000][16362][safepoint ] Application time: 0,0593610 seconds +[2018-06-14T08:51:41.783+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002072 seconds, Stopping threads took: 0,0000231 seconds +[2018-06-14T08:51:41.816+0000][16362][safepoint ] Application time: 0,0330307 seconds +[2018-06-14T08:51:41.816+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001953 seconds, Stopping threads took: 0,0000246 seconds +[2018-06-14T08:51:41.850+0000][16362][safepoint ] Application time: 0,0334107 seconds +[2018-06-14T08:51:41.850+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001816 seconds, Stopping threads took: 0,0000231 seconds +[2018-06-14T08:51:41.884+0000][16362][safepoint ] Application time: 0,0336901 seconds +[2018-06-14T08:51:41.884+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001868 seconds, Stopping threads took: 0,0000234 seconds +[2018-06-14T08:51:41.922+0000][16362][safepoint ] Application time: 0,0378443 seconds +[2018-06-14T08:51:41.922+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001622 seconds, Stopping threads took: 0,0000193 seconds +[2018-06-14T08:51:41.967+0000][16362][safepoint ] Application time: 0,0451040 seconds +[2018-06-14T08:51:41.967+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001881 seconds, Stopping threads took: 0,0000223 seconds +[2018-06-14T08:51:42.000+0000][16362][safepoint ] Application time: 0,0328833 seconds +[2018-06-14T08:51:42.001+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002393 seconds, Stopping threads took: 0,0000289 seconds +[2018-06-14T08:51:42.024+0000][16362][safepoint ] Application time: 0,0235513 seconds +[2018-06-14T08:51:42.024+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001921 seconds, Stopping threads took: 0,0000223 seconds +[2018-06-14T08:51:42.047+0000][16362][safepoint ] Application time: 0,0227962 seconds +[2018-06-14T08:51:42.047+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001940 seconds, Stopping threads took: 0,0000219 seconds +[2018-06-14T08:51:42.082+0000][16362][safepoint ] Application time: 0,0341833 seconds +[2018-06-14T08:51:42.082+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002036 seconds, Stopping threads took: 0,0000311 seconds +[2018-06-14T08:51:42.115+0000][16362][safepoint ] Application time: 0,0332724 seconds +[2018-06-14T08:51:42.115+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002050 seconds, Stopping threads took: 0,0000216 seconds +[2018-06-14T08:51:42.125+0000][16362][safepoint ] Application time: 0,0097647 seconds +[2018-06-14T08:51:42.125+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001270 seconds, Stopping threads took: 0,0000355 seconds +[2018-06-14T08:51:42.138+0000][16362][safepoint ] Application time: 0,0129702 seconds +[2018-06-14T08:51:42.139+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0005835 seconds, Stopping threads took: 0,0000257 seconds +[2018-06-14T08:51:42.142+0000][16362][safepoint ] Application time: 0,0032683 seconds +[2018-06-14T08:51:42.142+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001931 seconds, Stopping threads took: 0,0000221 seconds +[2018-06-14T08:51:42.152+0000][16362][safepoint ] Application time: 0,0095197 seconds +[2018-06-14T08:51:42.152+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001797 seconds, Stopping threads took: 0,0000813 seconds +[2018-06-14T08:51:42.153+0000][16362][safepoint ] Application time: 0,0005634 seconds +[2018-06-14T08:51:42.153+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001263 seconds, Stopping threads took: 0,0000375 seconds +[2018-06-14T08:51:42.153+0000][16362][safepoint ] Application time: 0,0006337 seconds +[2018-06-14T08:51:42.154+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000620 seconds, Stopping threads took: 0,0000210 seconds +[2018-06-14T08:51:42.154+0000][16362][safepoint ] Application time: 0,0007699 seconds +[2018-06-14T08:51:42.154+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000731 seconds, Stopping threads took: 0,0000228 seconds +[2018-06-14T08:51:42.155+0000][16362][safepoint ] Application time: 0,0001548 seconds +[2018-06-14T08:51:42.155+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000787 seconds, Stopping threads took: 0,0000184 seconds +[2018-06-14T08:51:42.156+0000][16362][safepoint ] Application time: 0,0009707 seconds +[2018-06-14T08:51:42.156+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000803 seconds, Stopping threads took: 0,0000352 seconds +[2018-06-14T08:51:42.156+0000][16362][safepoint ] Application time: 0,0000909 seconds +[2018-06-14T08:51:42.156+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000414 seconds, Stopping threads took: 0,0000114 seconds +[2018-06-14T08:51:42.156+0000][16362][safepoint ] Application time: 0,0000269 seconds +[2018-06-14T08:51:42.156+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000320 seconds, Stopping threads took: 0,0000098 seconds +[2018-06-14T08:51:42.159+0000][16362][safepoint ] Application time: 0,0027143 seconds +[2018-06-14T08:51:42.159+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001172 seconds, Stopping threads took: 0,0000465 seconds +[2018-06-14T08:51:42.160+0000][16362][safepoint ] Application time: 0,0010384 seconds +[2018-06-14T08:51:42.161+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0005788 seconds, Stopping threads took: 0,0000199 seconds +[2018-06-14T08:51:42.162+0000][16362][safepoint ] Application time: 0,0013340 seconds +[2018-06-14T08:51:42.162+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000581 seconds, Stopping threads took: 0,0000191 seconds +[2018-06-14T08:51:42.162+0000][16362][safepoint ] Application time: 0,0000583 seconds +[2018-06-14T08:51:42.162+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000414 seconds, Stopping threads took: 0,0000121 seconds +[2018-06-14T08:51:42.162+0000][16362][safepoint ] Application time: 0,0000441 seconds +[2018-06-14T08:51:42.162+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000391 seconds, Stopping threads took: 0,0000108 seconds +[2018-06-14T08:51:42.162+0000][16362][safepoint ] Application time: 0,0000575 seconds +[2018-06-14T08:51:42.162+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000391 seconds, Stopping threads took: 0,0000113 seconds +[2018-06-14T08:51:42.162+0000][16362][safepoint ] Application time: 0,0000569 seconds +[2018-06-14T08:51:42.162+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000397 seconds, Stopping threads took: 0,0000110 seconds +[2018-06-14T08:51:42.181+0000][16362][safepoint ] Application time: 0,0189917 seconds +[2018-06-14T08:51:42.182+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001450 seconds, Stopping threads took: 0,0000232 seconds +[2018-06-14T08:51:42.191+0000][16362][safepoint ] Application time: 0,0091917 seconds +[2018-06-14T08:51:42.191+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001891 seconds, Stopping threads took: 0,0000235 seconds +[2018-06-14T08:51:42.198+0000][16362][safepoint ] Application time: 0,0064460 seconds +[2018-06-14T08:51:42.198+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000885 seconds, Stopping threads took: 0,0000336 seconds +[2018-06-14T08:51:42.199+0000][16362][safepoint ] Application time: 0,0017350 seconds +[2018-06-14T08:51:42.200+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000815 seconds, Stopping threads took: 0,0000267 seconds +[2018-06-14T08:51:42.201+0000][16362][safepoint ] Application time: 0,0018839 seconds +[2018-06-14T08:51:42.202+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001030 seconds, Stopping threads took: 0,0000689 seconds +[2018-06-14T08:51:42.202+0000][16362][safepoint ] Application time: 0,0000448 seconds +[2018-06-14T08:51:42.202+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001593 seconds, Stopping threads took: 0,0001285 seconds +[2018-06-14T08:51:42.202+0000][16362][safepoint ] Application time: 0,0004925 seconds +[2018-06-14T08:51:42.202+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000668 seconds, Stopping threads took: 0,0000372 seconds +[2018-06-14T08:51:42.202+0000][16362][safepoint ] Application time: 0,0000289 seconds +[2018-06-14T08:51:42.203+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000768 seconds, Stopping threads took: 0,0000383 seconds +[2018-06-14T08:51:42.203+0000][16362][safepoint ] Application time: 0,0007761 seconds +[2018-06-14T08:51:42.204+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004164 seconds, Stopping threads took: 0,0003574 seconds +[2018-06-14T08:51:42.204+0000][16362][safepoint ] Application time: 0,0000808 seconds +[2018-06-14T08:51:42.204+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001359 seconds, Stopping threads took: 0,0000635 seconds +[2018-06-14T08:51:42.204+0000][16362][safepoint ] Application time: 0,0002319 seconds +[2018-06-14T08:51:42.204+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001128 seconds, Stopping threads took: 0,0000679 seconds +[2018-06-14T08:51:42.205+0000][16362][safepoint ] Application time: 0,0005129 seconds +[2018-06-14T08:51:42.205+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001730 seconds, Stopping threads took: 0,0001149 seconds +[2018-06-14T08:51:42.205+0000][16362][safepoint ] Application time: 0,0000273 seconds +[2018-06-14T08:51:42.205+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000595 seconds, Stopping threads took: 0,0000136 seconds +[2018-06-14T08:51:42.206+0000][16362][safepoint ] Application time: 0,0007109 seconds +[2018-06-14T08:51:42.206+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001068 seconds, Stopping threads took: 0,0000630 seconds +[2018-06-14T08:51:42.208+0000][16362][safepoint ] Application time: 0,0018580 seconds +[2018-06-14T08:51:42.208+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001325 seconds, Stopping threads took: 0,0000273 seconds +[2018-06-14T08:51:42.215+0000][16362][safepoint ] Application time: 0,0067300 seconds +[2018-06-14T08:51:42.215+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000908 seconds, Stopping threads took: 0,0000312 seconds +[2018-06-14T08:51:42.218+0000][16362][safepoint ] Application time: 0,0034251 seconds +[2018-06-14T08:51:42.219+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001018 seconds, Stopping threads took: 0,0000496 seconds +[2018-06-14T08:51:42.219+0000][16362][safepoint ] Application time: 0,0001484 seconds +[2018-06-14T08:51:42.219+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000823 seconds, Stopping threads took: 0,0000383 seconds +[2018-06-14T08:51:42.219+0000][16362][safepoint ] Application time: 0,0000605 seconds +[2018-06-14T08:51:42.219+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000827 seconds, Stopping threads took: 0,0000302 seconds +[2018-06-14T08:51:42.220+0000][16362][safepoint ] Application time: 0,0007024 seconds +[2018-06-14T08:51:42.223+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0032009 seconds, Stopping threads took: 0,0030949 seconds +[2018-06-14T08:51:42.223+0000][16362][safepoint ] Application time: 0,0000745 seconds +[2018-06-14T08:51:42.223+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001349 seconds, Stopping threads took: 0,0001009 seconds +[2018-06-14T08:51:42.228+0000][16362][safepoint ] Application time: 0,0045839 seconds +[2018-06-14T08:51:42.228+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000965 seconds, Stopping threads took: 0,0000373 seconds +[2018-06-14T08:51:42.228+0000][16362][safepoint ] Application time: 0,0000566 seconds +[2018-06-14T08:51:42.228+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000867 seconds, Stopping threads took: 0,0000541 seconds +[2018-06-14T08:51:42.228+0000][16362][safepoint ] Application time: 0,0001127 seconds +[2018-06-14T08:51:42.228+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000964 seconds, Stopping threads took: 0,0000378 seconds +[2018-06-14T08:51:42.229+0000][16362][safepoint ] Application time: 0,0007805 seconds +[2018-06-14T08:51:42.229+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000973 seconds, Stopping threads took: 0,0000327 seconds +[2018-06-14T08:51:42.232+0000][16362][safepoint ] Application time: 0,0030727 seconds +[2018-06-14T08:51:42.232+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001176 seconds, Stopping threads took: 0,0000217 seconds +[2018-06-14T08:51:42.233+0000][16362][safepoint ] Application time: 0,0006524 seconds +[2018-06-14T08:51:42.233+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001326 seconds, Stopping threads took: 0,0000531 seconds +[2018-06-14T08:51:42.233+0000][16362][safepoint ] Application time: 0,0000438 seconds +[2018-06-14T08:51:42.234+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0003876 seconds, Stopping threads took: 0,0000251 seconds +[2018-06-14T08:51:42.236+0000][16362][safepoint ] Application time: 0,0019995 seconds +[2018-06-14T08:51:42.236+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002444 seconds, Stopping threads took: 0,0001983 seconds +[2018-06-14T08:51:42.236+0000][16362][safepoint ] Application time: 0,0001152 seconds +[2018-06-14T08:51:42.236+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000795 seconds, Stopping threads took: 0,0000399 seconds +[2018-06-14T08:51:42.239+0000][16362][safepoint ] Application time: 0,0025636 seconds +[2018-06-14T08:51:42.239+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002186 seconds, Stopping threads took: 0,0000492 seconds +[2018-06-14T08:51:42.239+0000][16362][safepoint ] Application time: 0,0000401 seconds +[2018-06-14T08:51:42.239+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000769 seconds, Stopping threads took: 0,0000332 seconds +[2018-06-14T08:51:42.239+0000][16362][safepoint ] Application time: 0,0000278 seconds +[2018-06-14T08:51:42.239+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000655 seconds, Stopping threads took: 0,0000316 seconds +[2018-06-14T08:51:42.240+0000][16362][safepoint ] Application time: 0,0001401 seconds +[2018-06-14T08:51:42.240+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001919 seconds, Stopping threads took: 0,0000888 seconds +[2018-06-14T08:51:42.240+0000][16362][safepoint ] Application time: 0,0000480 seconds +[2018-06-14T08:51:42.240+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000724 seconds, Stopping threads took: 0,0000285 seconds +[2018-06-14T08:51:42.240+0000][16362][safepoint ] Application time: 0,0000893 seconds +[2018-06-14T08:51:42.240+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000694 seconds, Stopping threads took: 0,0000226 seconds +[2018-06-14T08:51:42.242+0000][16362][safepoint ] Application time: 0,0018976 seconds +[2018-06-14T08:51:42.242+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000819 seconds, Stopping threads took: 0,0000323 seconds +[2018-06-14T08:51:42.242+0000][16362][safepoint ] Application time: 0,0000538 seconds +[2018-06-14T08:51:42.242+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0003074 seconds, Stopping threads took: 0,0000361 seconds +[2018-06-14T08:51:42.242+0000][16362][safepoint ] Application time: 0,0000649 seconds +[2018-06-14T08:51:42.243+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001080 seconds, Stopping threads took: 0,0000719 seconds +[2018-06-14T08:51:42.243+0000][16362][safepoint ] Application time: 0,0006339 seconds +[2018-06-14T08:51:42.243+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001116 seconds, Stopping threads took: 0,0000514 seconds +[2018-06-14T08:51:42.246+0000][16362][safepoint ] Application time: 0,0028118 seconds +[2018-06-14T08:51:42.246+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001035 seconds, Stopping threads took: 0,0000352 seconds +[2018-06-14T08:51:42.246+0000][16362][safepoint ] Application time: 0,0000255 seconds +[2018-06-14T08:51:42.246+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000743 seconds, Stopping threads took: 0,0000317 seconds +[2018-06-14T08:51:42.247+0000][16362][safepoint ] Application time: 0,0000614 seconds +[2018-06-14T08:51:42.247+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000717 seconds, Stopping threads took: 0,0000253 seconds +[2018-06-14T08:51:42.247+0000][16362][safepoint ] Application time: 0,0000911 seconds +[2018-06-14T08:51:42.247+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000738 seconds, Stopping threads took: 0,0000204 seconds +[2018-06-14T08:51:42.249+0000][16362][safepoint ] Application time: 0,0026441 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000782 seconds, Stopping threads took: 0,0000240 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Application time: 0,0000564 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000795 seconds, Stopping threads took: 0,0000318 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Application time: 0,0000507 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000754 seconds, Stopping threads took: 0,0000272 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Application time: 0,0000514 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001123 seconds, Stopping threads took: 0,0000620 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Application time: 0,0000449 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000776 seconds, Stopping threads took: 0,0000322 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Application time: 0,0000470 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000704 seconds, Stopping threads took: 0,0000382 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Application time: 0,0000688 seconds +[2018-06-14T08:51:42.250+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000608 seconds, Stopping threads took: 0,0000224 seconds +[2018-06-14T08:51:42.251+0000][16362][safepoint ] Application time: 0,0000418 seconds +[2018-06-14T08:51:42.251+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000444 seconds, Stopping threads took: 0,0000119 seconds +[2018-06-14T08:51:42.251+0000][16362][safepoint ] Application time: 0,0008087 seconds +[2018-06-14T08:51:42.252+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001567 seconds, Stopping threads took: 0,0000646 seconds +[2018-06-14T08:51:42.252+0000][16362][safepoint ] Application time: 0,0004341 seconds +[2018-06-14T08:51:42.252+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001252 seconds, Stopping threads took: 0,0000401 seconds +[2018-06-14T08:51:42.253+0000][16362][safepoint ] Application time: 0,0004309 seconds +[2018-06-14T08:51:42.253+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001121 seconds, Stopping threads took: 0,0000272 seconds +[2018-06-14T08:51:42.253+0000][16362][safepoint ] Application time: 0,0000208 seconds +[2018-06-14T08:51:42.253+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000863 seconds, Stopping threads took: 0,0000375 seconds +[2018-06-14T08:51:42.254+0000][16362][safepoint ] Application time: 0,0015366 seconds +[2018-06-14T08:51:42.255+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004128 seconds, Stopping threads took: 0,0000730 seconds +[2018-06-14T08:51:42.256+0000][16362][safepoint ] Application time: 0,0014132 seconds +[2018-06-14T08:51:42.256+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001239 seconds, Stopping threads took: 0,0000493 seconds +[2018-06-14T08:51:43.215+0000][16362][safepoint ] Application time: 0,9588062 seconds +[2018-06-14T08:51:43.215+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000628 seconds, Stopping threads took: 0,0000163 seconds +[2018-06-14T08:51:43.217+0000][16362][safepoint ] Application time: 0,0012567 seconds +[2018-06-14T08:51:43.217+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001217 seconds, Stopping threads took: 0,0000494 seconds +[2018-06-14T08:51:43.217+0000][16362][safepoint ] Application time: 0,0003578 seconds +[2018-06-14T08:51:43.217+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001858 seconds, Stopping threads took: 0,0000716 seconds +[2018-06-14T08:51:43.218+0000][16362][safepoint ] Application time: 0,0005081 seconds +[2018-06-14T08:51:43.218+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001267 seconds, Stopping threads took: 0,0000708 seconds +[2018-06-14T08:51:43.218+0000][16362][safepoint ] Application time: 0,0000601 seconds +[2018-06-14T08:51:43.218+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000840 seconds, Stopping threads took: 0,0000279 seconds +[2018-06-14T08:51:43.218+0000][16362][safepoint ] Application time: 0,0000680 seconds +[2018-06-14T08:51:43.218+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001427 seconds, Stopping threads took: 0,0000839 seconds +[2018-06-14T08:51:43.219+0000][16362][safepoint ] Application time: 0,0010230 seconds +[2018-06-14T08:51:43.220+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001691 seconds, Stopping threads took: 0,0000429 seconds +[2018-06-14T08:51:43.221+0000][16362][safepoint ] Application time: 0,0014812 seconds +[2018-06-14T08:51:43.221+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001456 seconds, Stopping threads took: 0,0000283 seconds +[2018-06-14T08:51:43.222+0000][16362][safepoint ] Application time: 0,0011009 seconds +[2018-06-14T08:51:43.223+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000846 seconds, Stopping threads took: 0,0000176 seconds +[2018-06-14T08:51:43.223+0000][16362][gc ] GC(6) Concurrent Abortable Preclean 2184,550ms +[2018-06-14T08:51:43.223+0000][16362][gc,cpu ] GC(6) User=6,61s Sys=0,04s Real=2,18s +[2018-06-14T08:51:43.223+0000][16362][safepoint ] Application time: 0,0000687 seconds +[2018-06-14T08:51:43.223+0000][16362][gc,start ] GC(6) Pause Remark +[2018-06-14T08:51:43.251+0000][16362][gc ] GC(6) Pause Remark 208M->208M(989M) 27,988ms +[2018-06-14T08:51:43.251+0000][16362][gc,cpu ] GC(6) User=0,09s Sys=0,00s Real=0,03s +[2018-06-14T08:51:43.251+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0281965 seconds, Stopping threads took: 0,0000823 seconds +[2018-06-14T08:51:43.251+0000][16362][gc ] GC(6) Concurrent Sweep +[2018-06-14T08:51:43.251+0000][16362][safepoint ] Application time: 0,0001052 seconds +[2018-06-14T08:51:43.251+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000739 seconds, Stopping threads took: 0,0000314 seconds +[2018-06-14T08:51:43.251+0000][16362][safepoint ] Application time: 0,0000553 seconds +[2018-06-14T08:51:43.251+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000919 seconds, Stopping threads took: 0,0000572 seconds +[2018-06-14T08:51:43.251+0000][16362][safepoint ] Application time: 0,0001589 seconds +[2018-06-14T08:51:43.251+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000860 seconds, Stopping threads took: 0,0000264 seconds +[2018-06-14T08:51:43.252+0000][16362][safepoint ] Application time: 0,0001478 seconds +[2018-06-14T08:51:43.252+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000878 seconds, Stopping threads took: 0,0000364 seconds +[2018-06-14T08:51:43.252+0000][16362][safepoint ] Application time: 0,0000739 seconds +[2018-06-14T08:51:43.252+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001324 seconds, Stopping threads took: 0,0000903 seconds +[2018-06-14T08:51:43.252+0000][16362][safepoint ] Application time: 0,0000634 seconds +[2018-06-14T08:51:43.252+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000750 seconds, Stopping threads took: 0,0000384 seconds +[2018-06-14T08:51:43.261+0000][16362][gc ] GC(6) Concurrent Sweep 9,915ms +[2018-06-14T08:51:43.261+0000][16362][gc,cpu ] GC(6) User=0,00s Sys=0,01s Real=0,01s +[2018-06-14T08:51:43.261+0000][16362][gc ] GC(6) Concurrent Reset +[2018-06-14T08:51:43.261+0000][16362][gc ] GC(6) Concurrent Reset 0,435ms +[2018-06-14T08:51:43.261+0000][16362][gc,cpu ] GC(6) User=0,01s Sys=0,00s Real=0,00s +[2018-06-14T08:51:43.261+0000][16362][gc,heap ] GC(6) Old: 17582K->35442K(699072K) +[2018-06-14T08:51:44.215+0000][16362][safepoint ] Application time: 0,9632641 seconds +[2018-06-14T08:51:44.215+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000728 seconds, Stopping threads took: 0,0000198 seconds +[2018-06-14T08:51:44.216+0000][16362][safepoint ] Application time: 0,0005996 seconds +[2018-06-14T08:51:44.217+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004105 seconds, Stopping threads took: 0,0001125 seconds +[2018-06-14T08:51:44.217+0000][16362][safepoint ] Application time: 0,0001848 seconds +[2018-06-14T08:51:44.217+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004058 seconds, Stopping threads took: 0,0001140 seconds +[2018-06-14T08:51:44.217+0000][16362][safepoint ] Application time: 0,0001291 seconds +[2018-06-14T08:51:44.217+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001394 seconds, Stopping threads took: 0,0000935 seconds +[2018-06-14T08:51:44.218+0000][16362][safepoint ] Application time: 0,0001840 seconds +[2018-06-14T08:51:44.218+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004120 seconds, Stopping threads took: 0,0000836 seconds +[2018-06-14T08:51:44.218+0000][16362][safepoint ] Application time: 0,0001150 seconds +[2018-06-14T08:51:44.218+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001701 seconds, Stopping threads took: 0,0001100 seconds +[2018-06-14T08:51:44.219+0000][16362][safepoint ] Application time: 0,0004191 seconds +[2018-06-14T08:51:44.219+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0003406 seconds, Stopping threads took: 0,0000188 seconds +[2018-06-14T08:51:45.219+0000][16362][safepoint ] Application time: 1,0000166 seconds +[2018-06-14T08:51:45.219+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001168 seconds, Stopping threads took: 0,0000228 seconds +[2018-06-14T08:51:45.220+0000][16362][safepoint ] Application time: 0,0000950 seconds +[2018-06-14T08:51:45.220+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000454 seconds, Stopping threads took: 0,0000097 seconds +[2018-06-14T08:51:45.240+0000][16362][safepoint ] Application time: 0,0199903 seconds +[2018-06-14T08:51:45.240+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002336 seconds, Stopping threads took: 0,0001545 seconds +[2018-06-14T08:51:45.241+0000][16362][safepoint ] Application time: 0,0016453 seconds +[2018-06-14T08:51:45.242+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001445 seconds, Stopping threads took: 0,0000844 seconds +[2018-06-14T08:51:45.242+0000][16362][safepoint ] Application time: 0,0004448 seconds +[2018-06-14T08:51:45.242+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000875 seconds, Stopping threads took: 0,0000315 seconds +[2018-06-14T08:51:45.245+0000][16362][safepoint ] Application time: 0,0027621 seconds +[2018-06-14T08:51:45.245+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001194 seconds, Stopping threads took: 0,0000396 seconds +[2018-06-14T08:51:45.249+0000][16362][safepoint ] Application time: 0,0035188 seconds +[2018-06-14T08:51:45.249+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001512 seconds, Stopping threads took: 0,0000897 seconds +[2018-06-14T08:51:45.249+0000][16362][safepoint ] Application time: 0,0001153 seconds +[2018-06-14T08:51:45.249+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001021 seconds, Stopping threads took: 0,0000568 seconds +[2018-06-14T08:51:45.250+0000][16362][safepoint ] Application time: 0,0007785 seconds +[2018-06-14T08:51:45.250+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000789 seconds, Stopping threads took: 0,0000349 seconds +[2018-06-14T08:51:45.250+0000][16362][safepoint ] Application time: 0,0000560 seconds +[2018-06-14T08:51:45.250+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000540 seconds, Stopping threads took: 0,0000223 seconds +[2018-06-14T08:51:45.253+0000][16362][safepoint ] Application time: 0,0027738 seconds +[2018-06-14T08:51:45.253+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000750 seconds, Stopping threads took: 0,0000225 seconds +[2018-06-14T08:51:45.279+0000][16362][safepoint ] Application time: 0,0257805 seconds +[2018-06-14T08:51:45.279+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002361 seconds, Stopping threads took: 0,0001142 seconds +[2018-06-14T08:51:45.283+0000][16362][safepoint ] Application time: 0,0037806 seconds +[2018-06-14T08:51:45.283+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0005859 seconds, Stopping threads took: 0,0000438 seconds +[2018-06-14T08:51:45.285+0000][16362][safepoint ] Application time: 0,0014088 seconds +[2018-06-14T08:51:45.285+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001308 seconds, Stopping threads took: 0,0000547 seconds +[2018-06-14T08:51:45.312+0000][16362][safepoint ] Application time: 0,0273052 seconds +[2018-06-14T08:51:45.313+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001850 seconds, Stopping threads took: 0,0000928 seconds +[2018-06-14T08:51:45.315+0000][16362][safepoint ] Application time: 0,0021229 seconds +[2018-06-14T08:51:45.315+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001776 seconds, Stopping threads took: 0,0001270 seconds +[2018-06-14T08:51:45.317+0000][16362][safepoint ] Application time: 0,0023550 seconds +[2018-06-14T08:51:45.318+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001981 seconds, Stopping threads took: 0,0001243 seconds +[2018-06-14T08:51:45.394+0000][16362][safepoint ] Application time: 0,0759444 seconds +[2018-06-14T08:51:45.394+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0006485 seconds, Stopping threads took: 0,0002091 seconds +[2018-06-14T08:51:45.464+0000][16362][safepoint ] Application time: 0,0698179 seconds +[2018-06-14T08:51:45.464+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002183 seconds, Stopping threads took: 0,0000556 seconds +[2018-06-14T08:51:45.494+0000][16362][safepoint ] Application time: 0,0299109 seconds +[2018-06-14T08:51:45.494+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001538 seconds, Stopping threads took: 0,0000517 seconds +[2018-06-14T08:51:45.524+0000][16362][safepoint ] Application time: 0,0291210 seconds +[2018-06-14T08:51:45.524+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001520 seconds, Stopping threads took: 0,0000619 seconds +[2018-06-14T08:51:45.560+0000][16362][safepoint ] Application time: 0,0366550 seconds +[2018-06-14T08:51:45.561+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002969 seconds, Stopping threads took: 0,0000789 seconds +[2018-06-14T08:51:45.600+0000][16362][safepoint ] Application time: 0,0396216 seconds +[2018-06-14T08:51:45.601+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001202 seconds, Stopping threads took: 0,0000438 seconds +[2018-06-14T08:51:45.628+0000][16362][safepoint ] Application time: 0,0273974 seconds +[2018-06-14T08:51:45.628+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001563 seconds, Stopping threads took: 0,0000497 seconds +[2018-06-14T08:51:45.653+0000][16362][safepoint ] Application time: 0,0247952 seconds +[2018-06-14T08:51:45.653+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001552 seconds, Stopping threads took: 0,0000554 seconds +[2018-06-14T08:51:45.718+0000][16362][safepoint ] Application time: 0,0651317 seconds +[2018-06-14T08:51:45.719+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001446 seconds, Stopping threads took: 0,0000307 seconds +[2018-06-14T08:51:45.743+0000][16362][safepoint ] Application time: 0,0242399 seconds +[2018-06-14T08:51:45.743+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001251 seconds, Stopping threads took: 0,0000375 seconds +[2018-06-14T08:51:46.743+0000][16362][safepoint ] Application time: 1,0001354 seconds +[2018-06-14T08:51:46.743+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001481 seconds, Stopping threads took: 0,0000438 seconds +[2018-06-14T08:51:47.743+0000][16362][safepoint ] Application time: 1,0001291 seconds +[2018-06-14T08:51:47.744+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001009 seconds, Stopping threads took: 0,0000302 seconds +[2018-06-14T08:51:49.744+0000][16362][safepoint ] Application time: 2,0002390 seconds +[2018-06-14T08:51:49.744+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002529 seconds, Stopping threads took: 0,0000653 seconds +[2018-06-14T08:51:50.744+0000][16362][safepoint ] Application time: 1,0001150 seconds +[2018-06-14T08:51:50.745+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002458 seconds, Stopping threads took: 0,0000667 seconds +[2018-06-14T08:51:52.745+0000][16362][safepoint ] Application time: 2,0002719 seconds +[2018-06-14T08:51:52.745+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001912 seconds, Stopping threads took: 0,0000549 seconds +[2018-06-14T08:51:53.745+0000][16362][safepoint ] Application time: 1,0001101 seconds +[2018-06-14T08:51:53.746+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002052 seconds, Stopping threads took: 0,0000617 seconds +[2018-06-14T08:51:54.746+0000][16362][safepoint ] Application time: 1,0001439 seconds +[2018-06-14T08:51:54.746+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002307 seconds, Stopping threads took: 0,0000745 seconds +[2018-06-14T08:51:55.746+0000][16362][safepoint ] Application time: 1,0001003 seconds +[2018-06-14T08:51:55.747+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002295 seconds, Stopping threads took: 0,0000597 seconds +[2018-06-14T08:51:57.747+0000][16362][safepoint ] Application time: 2,0002617 seconds +[2018-06-14T08:51:57.747+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001675 seconds, Stopping threads took: 0,0000456 seconds +[2018-06-14T08:52:00.748+0000][16362][safepoint ] Application time: 3,0003854 seconds +[2018-06-14T08:52:00.748+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002417 seconds, Stopping threads took: 0,0000794 seconds +[2018-06-14T08:52:02.748+0000][16362][safepoint ] Application time: 2,0002478 seconds +[2018-06-14T08:52:02.748+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002016 seconds, Stopping threads took: 0,0000599 seconds +[2018-06-14T08:52:12.750+0000][16362][safepoint ] Application time: 10,0010156 seconds +[2018-06-14T08:52:12.750+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001714 seconds, Stopping threads took: 0,0000697 seconds +[2018-06-14T08:52:15.750+0000][16362][safepoint ] Application time: 3,0002439 seconds +[2018-06-14T08:52:15.750+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002375 seconds, Stopping threads took: 0,0000563 seconds +[2018-06-14T08:52:17.751+0000][16362][safepoint ] Application time: 2,0002757 seconds +[2018-06-14T08:52:17.751+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002133 seconds, Stopping threads took: 0,0000574 seconds +[2018-06-14T08:52:21.752+0000][16362][safepoint ] Application time: 4,0006570 seconds +[2018-06-14T08:52:21.752+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001285 seconds, Stopping threads took: 0,0000270 seconds +[2018-06-14T08:52:27.753+0000][16362][safepoint ] Application time: 6,0008362 seconds +[2018-06-14T08:52:27.753+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002503 seconds, Stopping threads took: 0,0000769 seconds +[2018-06-14T08:52:35.754+0000][16362][safepoint ] Application time: 8,0010903 seconds +[2018-06-14T08:52:35.754+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001765 seconds, Stopping threads took: 0,0000517 seconds +[2018-06-14T08:52:37.755+0000][16362][safepoint ] Application time: 2,0002255 seconds +[2018-06-14T08:52:37.755+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002166 seconds, Stopping threads took: 0,0000658 seconds +[2018-06-14T08:52:40.755+0000][16362][safepoint ] Application time: 3,0003818 seconds +[2018-06-14T08:52:40.755+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001019 seconds, Stopping threads took: 0,0000356 seconds +[2018-06-14T08:52:43.762+0000][16362][safepoint ] Application time: 3,0004078 seconds +[2018-06-14T08:52:43.762+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002470 seconds, Stopping threads took: 0,0000609 seconds +[2018-06-14T08:52:45.762+0000][16362][safepoint ] Application time: 2,0002168 seconds +[2018-06-14T08:52:45.762+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002086 seconds, Stopping threads took: 0,0000776 seconds +[2018-06-14T08:52:49.324+0000][16362][safepoint ] Application time: 3,5594683 seconds +[2018-06-14T08:52:49.324+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001749 seconds, Stopping threads took: 0,0001159 seconds +[2018-06-14T08:52:49.326+0000][16362][safepoint ] Application time: 0,0021177 seconds +[2018-06-14T08:52:49.326+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000938 seconds, Stopping threads took: 0,0000380 seconds +[2018-06-14T08:52:49.327+0000][16362][safepoint ] Application time: 0,0002746 seconds +[2018-06-14T08:52:49.327+0000][16362][gc,start ] GC(8) Pause Young (Allocation Failure) +[2018-06-14T08:52:49.327+0000][16362][gc,task ] GC(8) Using 8 workers of 8 for evacuation +[2018-06-14T08:52:49.345+0000][16362][gc,age ] GC(8) Desired survivor size 17891328 bytes, new threshold 1 (max threshold 6) +[2018-06-14T08:52:49.345+0000][16362][gc,age ] GC(8) Age table with threshold 1 (max threshold 6) +[2018-06-14T08:52:49.345+0000][16362][gc,age ] GC(8) - age 1: 18434176 bytes, 18434176 total +[2018-06-14T08:52:49.345+0000][16362][gc,heap ] GC(8) ParNew: 314559K->25972K(314560K) +[2018-06-14T08:52:49.345+0000][16362][gc,heap ] GC(8) CMS: 35442K->46551K(699072K) +[2018-06-14T08:52:49.345+0000][16362][gc,metaspace ] GC(8) Metaspace: 70247K->70247K(1116160K) +[2018-06-14T08:52:49.345+0000][16362][gc ] GC(8) Pause Young (Allocation Failure) 341M->70M(989M) 18,681ms +[2018-06-14T08:52:49.345+0000][16362][gc,cpu ] GC(8) User=0,10s Sys=0,00s Real=0,02s +[2018-06-14T08:52:49.345+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0187972 seconds, Stopping threads took: 0,0000137 seconds +[2018-06-14T08:52:49.346+0000][16362][safepoint ] Application time: 0,0003864 seconds +[2018-06-14T08:52:49.346+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000814 seconds, Stopping threads took: 0,0000169 seconds +[2018-06-14T08:52:49.346+0000][16362][safepoint ] Application time: 0,0001702 seconds +[2018-06-14T08:52:49.346+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001560 seconds, Stopping threads took: 0,0000995 seconds +[2018-06-14T08:52:49.346+0000][16362][safepoint ] Application time: 0,0002243 seconds +[2018-06-14T08:52:49.347+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000913 seconds, Stopping threads took: 0,0000209 seconds +[2018-06-14T08:52:49.347+0000][16362][safepoint ] Application time: 0,0001058 seconds +[2018-06-14T08:52:49.347+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000674 seconds, Stopping threads took: 0,0000268 seconds +[2018-06-14T08:52:49.347+0000][16362][safepoint ] Application time: 0,0000773 seconds +[2018-06-14T08:52:49.347+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000553 seconds, Stopping threads took: 0,0000215 seconds +[2018-06-14T08:52:49.347+0000][16362][safepoint ] Application time: 0,0000993 seconds +[2018-06-14T08:52:49.347+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000452 seconds, Stopping threads took: 0,0000116 seconds +[2018-06-14T08:52:49.347+0000][16362][safepoint ] Application time: 0,0001218 seconds +[2018-06-14T08:52:49.347+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001150 seconds, Stopping threads took: 0,0000723 seconds +[2018-06-14T08:52:49.348+0000][16362][safepoint ] Application time: 0,0006903 seconds +[2018-06-14T08:52:49.348+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001347 seconds, Stopping threads took: 0,0000887 seconds +[2018-06-14T08:52:49.348+0000][16362][safepoint ] Application time: 0,0000907 seconds +[2018-06-14T08:52:49.349+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0007697 seconds, Stopping threads took: 0,0000312 seconds +[2018-06-14T08:52:49.352+0000][16362][safepoint ] Application time: 0,0027508 seconds +[2018-06-14T08:52:49.352+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004287 seconds, Stopping threads took: 0,0001043 seconds +[2018-06-14T08:52:49.352+0000][16362][safepoint ] Application time: 0,0001008 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001676 seconds, Stopping threads took: 0,0000928 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Application time: 0,0000506 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000725 seconds, Stopping threads took: 0,0000412 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Application time: 0,0000198 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000852 seconds, Stopping threads took: 0,0000444 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Application time: 0,0000167 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000906 seconds, Stopping threads took: 0,0000514 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Application time: 0,0000189 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000589 seconds, Stopping threads took: 0,0000197 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Application time: 0,0000230 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000708 seconds, Stopping threads took: 0,0000350 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Application time: 0,0000155 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000548 seconds, Stopping threads took: 0,0000278 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Application time: 0,0000128 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000483 seconds, Stopping threads took: 0,0000211 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Application time: 0,0000139 seconds +[2018-06-14T08:52:49.353+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000539 seconds, Stopping threads took: 0,0000263 seconds +[2018-06-14T08:52:49.356+0000][16362][safepoint ] Application time: 0,0023642 seconds +[2018-06-14T08:52:49.356+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001232 seconds, Stopping threads took: 0,0000516 seconds +[2018-06-14T08:52:49.356+0000][16362][safepoint ] Application time: 0,0000653 seconds +[2018-06-14T08:52:49.356+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002138 seconds, Stopping threads took: 0,0001431 seconds +[2018-06-14T08:52:49.357+0000][16362][safepoint ] Application time: 0,0003754 seconds +[2018-06-14T08:52:49.357+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0004766 seconds, Stopping threads took: 0,0001443 seconds +[2018-06-14T08:52:49.357+0000][16362][safepoint ] Application time: 0,0002023 seconds +[2018-06-14T08:52:49.358+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001324 seconds, Stopping threads took: 0,0000394 seconds +[2018-06-14T08:52:49.358+0000][16362][safepoint ] Application time: 0,0003320 seconds +[2018-06-14T08:52:49.358+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001611 seconds, Stopping threads took: 0,0000928 seconds +[2018-06-14T08:52:49.358+0000][16362][safepoint ] Application time: 0,0001964 seconds +[2018-06-14T08:52:49.358+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000882 seconds, Stopping threads took: 0,0000323 seconds +[2018-06-14T08:52:49.358+0000][16362][safepoint ] Application time: 0,0000438 seconds +[2018-06-14T08:52:49.359+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000724 seconds, Stopping threads took: 0,0000381 seconds +[2018-06-14T08:52:49.359+0000][16362][safepoint ] Application time: 0,0000657 seconds +[2018-06-14T08:52:49.359+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000642 seconds, Stopping threads took: 0,0000209 seconds +[2018-06-14T08:52:49.359+0000][16362][safepoint ] Application time: 0,0001358 seconds +[2018-06-14T08:52:49.359+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000739 seconds, Stopping threads took: 0,0000314 seconds +[2018-06-14T08:52:49.359+0000][16362][safepoint ] Application time: 0,0001265 seconds +[2018-06-14T08:52:49.359+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000752 seconds, Stopping threads took: 0,0000347 seconds +[2018-06-14T08:52:49.359+0000][16362][safepoint ] Application time: 0,0000891 seconds +[2018-06-14T08:52:49.359+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000639 seconds, Stopping threads took: 0,0000254 seconds +[2018-06-14T08:52:49.360+0000][16362][safepoint ] Application time: 0,0004151 seconds +[2018-06-14T08:52:49.360+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000802 seconds, Stopping threads took: 0,0000262 seconds +[2018-06-14T08:52:49.360+0000][16362][safepoint ] Application time: 0,0001653 seconds +[2018-06-14T08:52:49.360+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000723 seconds, Stopping threads took: 0,0000237 seconds +[2018-06-14T08:52:49.360+0000][16362][safepoint ] Application time: 0,0000557 seconds +[2018-06-14T08:52:49.360+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000679 seconds, Stopping threads took: 0,0000361 seconds +[2018-06-14T08:52:49.360+0000][16362][safepoint ] Application time: 0,0000960 seconds +[2018-06-14T08:52:49.360+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000357 seconds, Stopping threads took: 0,0000073 seconds +[2018-06-14T08:52:49.361+0000][16362][safepoint ] Application time: 0,0008766 seconds +[2018-06-14T08:52:49.361+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001044 seconds, Stopping threads took: 0,0000247 seconds +[2018-06-14T08:52:49.362+0000][16362][safepoint ] Application time: 0,0003148 seconds +[2018-06-14T08:52:49.362+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000606 seconds, Stopping threads took: 0,0000134 seconds +[2018-06-14T08:52:49.542+0000][16362][safepoint ] Application time: 0,1802479 seconds +[2018-06-14T08:52:49.542+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000892 seconds, Stopping threads took: 0,0000189 seconds +[2018-06-14T08:52:49.543+0000][16362][safepoint ] Application time: 0,0007697 seconds +[2018-06-14T08:52:49.543+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000461 seconds, Stopping threads took: 0,0000216 seconds +[2018-06-14T08:52:49.543+0000][16362][safepoint ] Application time: 0,0000666 seconds +[2018-06-14T08:52:49.543+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000386 seconds, Stopping threads took: 0,0000190 seconds +[2018-06-14T08:52:49.543+0000][16362][safepoint ] Application time: 0,0001896 seconds +[2018-06-14T08:52:49.543+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000574 seconds, Stopping threads took: 0,0000150 seconds +[2018-06-14T08:52:49.545+0000][16362][safepoint ] Application time: 0,0019139 seconds +[2018-06-14T08:52:49.546+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002357 seconds, Stopping threads took: 0,0001932 seconds +[2018-06-14T08:52:49.546+0000][16362][safepoint ] Application time: 0,0000353 seconds +[2018-06-14T08:52:49.546+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000326 seconds, Stopping threads took: 0,0000095 seconds +[2018-06-14T08:52:49.546+0000][16362][safepoint ] Application time: 0,0001626 seconds +[2018-06-14T08:52:49.546+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000544 seconds, Stopping threads took: 0,0000179 seconds +[2018-06-14T08:52:49.546+0000][16362][safepoint ] Application time: 0,0001414 seconds +[2018-06-14T08:52:49.546+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000519 seconds, Stopping threads took: 0,0000211 seconds +[2018-06-14T08:52:49.548+0000][16362][safepoint ] Application time: 0,0015835 seconds +[2018-06-14T08:52:49.548+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001770 seconds, Stopping threads took: 0,0000769 seconds +[2018-06-14T08:52:49.548+0000][16362][safepoint ] Application time: 0,0001582 seconds +[2018-06-14T08:52:49.549+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0005883 seconds, Stopping threads took: 0,0000367 seconds +[2018-06-14T08:52:49.549+0000][16362][safepoint ] Application time: 0,0000198 seconds +[2018-06-14T08:52:49.549+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0000685 seconds, Stopping threads took: 0,0000269 seconds +[2018-06-14T08:52:49.549+0000][16362][safepoint ] Application time: 0,0001457 seconds +[2018-06-14T08:52:49.549+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0001048 seconds, Stopping threads took: 0,0000668 seconds +[2018-06-14T08:52:49.549+0000][16362][safepoint ] Application time: 0,0002355 seconds +[2018-06-14T08:52:49.550+0000][16362][safepoint ] Total time for which application threads were stopped: 0,0002841 seconds, Stopping threads took: 0,0000876 seconds +[2018-06-14T08:52:49.560+0000][16362][gc,heap,exit ] Heap +[2018-06-14T08:52:49.560+0000][16362][gc,heap,exit ] par new generation total 314560K, used 74011K [0x00000000c0000000, 0x00000000d5550000, 0x00000000d5550000) +[2018-06-14T08:52:49.560+0000][16362][gc,heap,exit ] eden space 279616K, 17% used [0x00000000c0000000, 0x00000000c2ee99c8, 0x00000000d1110000) +[2018-06-14T08:52:49.560+0000][16362][gc,heap,exit ] from space 34944K, 74% used [0x00000000d3330000, 0x00000000d4c8d270, 0x00000000d5550000) +[2018-06-14T08:52:49.560+0000][16362][gc,heap,exit ] to space 34944K, 0% used [0x00000000d1110000, 0x00000000d1110000, 0x00000000d3330000) +[2018-06-14T08:52:49.560+0000][16362][gc,heap,exit ] concurrent mark-sweep generation total 699072K, used 46551K [0x00000000d5550000, 0x0000000100000000, 0x0000000100000000) +[2018-06-14T08:52:49.560+0000][16362][gc,heap,exit ] Metaspace used 70380K, capacity 76872K, committed 76980K, reserved 1116160K +[2018-06-14T08:52:49.560+0000][16362][gc,heap,exit ] class space used 9240K, capacity 10992K, committed 11036K, reserved 1048576K +[2018-06-14T08:52:49.560+0000][16362][safepoint ] Application time: 0,0108063 seconds From 5eaafff6a38a73b59890bfe80b5aea50221ae98e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?No=C3=A9mi=20V=C3=A1nyi?= Date: Wed, 18 Jul 2018 13:55:13 +0200 Subject: [PATCH 06/34] Improve fields.yml generator of modules (#7533) From now on when a user provides a type hint in an Ingest pipeline, it's added to the generated `fields.yml` instead of guessing. Closes #7472 --- filebeat/scripts/generator/fields/main.go | 77 +++++++++++++------ .../scripts/generator/fields/main_test.go | 9 +++ 2 files changed, 61 insertions(+), 25 deletions(-) diff --git a/filebeat/scripts/generator/fields/main.go b/filebeat/scripts/generator/fields/main.go index 7a883160368c..385677163e59 100644 --- a/filebeat/scripts/generator/fields/main.go +++ b/filebeat/scripts/generator/fields/main.go @@ -33,6 +33,10 @@ import ( const ( pipelinePath = "%s/module/%s/%s/ingest/pipeline.json" fieldsYmlPath = "%s/module/%s/%s/_meta/fields.yml" + + typeIdx = 0 + elementsIdx = 1 + hintIdx = 2 ) var ( @@ -64,8 +68,9 @@ type pipeline struct { } type field struct { - Type string - Elements []string + Syntax string + SemanticElements []string + Type string } type fieldYml struct { @@ -92,23 +97,41 @@ func newFieldYml(name, typeName string, noDoc bool) *fieldYml { } } -func newField(lp string) field { - lp = lp[1 : len(lp)-1] - ee := strings.Split(lp, ":") - if len(ee) != 2 { - return field{ - Type: ee[0], - Elements: nil, - } +func newField(pattern string) field { + if len(pattern) <= 2 { + return field{} + } + pattern = pattern[1 : len(pattern)-1] + + elements := strings.Split(pattern, ":") + if !isValidFormat(elements) { + return field{} + } + + hint := "" + if containsType(elements) { + hint = elements[hintIdx] } - e := strings.Split(ee[1], ".") return field{ - Type: ee[0], - Elements: e, + Syntax: elements[typeIdx], + SemanticElements: strings.Split(elements[elementsIdx], "."), + Type: hint, } } +// isValidFormat checks if the input can be split correctly +// 1. if lenght is 2, the format is {type}:{field.elements} +// 2. if the lenght is 3, the format is {type}:{field.elements}:{hint} +func isValidFormat(ee []string) bool { + return len(ee) == 2 || len(ee) == 3 +} + +// the last element is the type hint +func containsType(ee []string) bool { + return len(ee) == 3 +} + func readPipeline(beatsPath, module, fileset string) (*pipeline, error) { pp := fmt.Sprintf(pipelinePath, beatsPath, module, fileset) r, err := ioutil.ReadFile(pp) @@ -134,7 +157,7 @@ func addNewField(fs []field, f field) []field { return append(fs, f) } -func getElementsFromPatterns(patterns []string) ([]field, error) { +func getSemanticElementsFromPatterns(patterns []string) ([]field, error) { r, err := regexp.Compile("{[\\.\\w\\:]*}") if err != nil { return nil, err @@ -145,7 +168,7 @@ func getElementsFromPatterns(patterns []string) ([]field, error) { pp := r.FindAllString(lp, -1) for _, p := range pp { f := newField(p) - if f.Elements == nil { + if f.SemanticElements == nil { continue } fs = addNewField(fs, f) @@ -214,16 +237,16 @@ type processors struct { } func (p *processors) processFields() ([]field, error) { - f, err := getElementsFromPatterns(p.patterns) + f, err := getSemanticElementsFromPatterns(p.patterns) if err != nil { return nil, err } for i, ff := range f { - fs := strings.Join(ff.Elements, ".") + fs := strings.Join(ff.SemanticElements, ".") for k, mv := range p.rename { if k == fs { - ff.Elements = strings.Split(mv, ".") + ff.SemanticElements = strings.Split(mv, ".") } } for _, rm := range p.remove { @@ -275,18 +298,22 @@ func getFieldByName(f []*fieldYml, name string) *fieldYml { return nil } -func insertLastField(f []*fieldYml, name, typeName string, noDoc bool) []*fieldYml { +func insertLastField(f []*fieldYml, name string, field field, noDoc bool) []*fieldYml { ff := getFieldByName(f, name) if ff != nil { return f } - nf := newFieldYml(name, types[typeName], noDoc) + fieldType := field.Type + if fieldType == "" { + fieldType = types[field.Syntax] + } + nf := newFieldYml(name, fieldType, noDoc) return append(f, nf) } func insertGroup(out []*fieldYml, field field, index, count int, noDoc bool) []*fieldYml { - g := getFieldByName(out, field.Elements[index]) + g := getFieldByName(out, field.SemanticElements[index]) if g != nil { g.Fields = generateField(g.Fields, field, index+1, count, noDoc) return out @@ -294,14 +321,14 @@ func insertGroup(out []*fieldYml, field field, index, count int, noDoc bool) []* var groupFields []*fieldYml groupFields = generateField(groupFields, field, index+1, count, noDoc) - group := newFieldYml(field.Elements[index], "group", noDoc) + group := newFieldYml(field.SemanticElements[index], "group", noDoc) group.Fields = groupFields return append(out, group) } func generateField(out []*fieldYml, field field, index, count int, noDoc bool) []*fieldYml { if index+1 == count { - return insertLastField(out, field.Elements[index], field.Type, noDoc) + return insertLastField(out, field.SemanticElements[index], field, noDoc) } return insertGroup(out, field, index, count, noDoc) } @@ -310,10 +337,10 @@ func generateFields(f []field, noDoc bool) []*fieldYml { var out []*fieldYml for _, ff := range f { index := 1 - if len(ff.Elements) == 1 { + if len(ff.SemanticElements) == 1 { index = 0 } - out = generateField(out, ff, index, len(ff.Elements), noDoc) + out = generateField(out, ff, index, len(ff.SemanticElements), noDoc) } return out } diff --git a/filebeat/scripts/generator/fields/main_test.go b/filebeat/scripts/generator/fields/main_test.go index 04f34bbeebed..a83d025e7fc0 100644 --- a/filebeat/scripts/generator/fields/main_test.go +++ b/filebeat/scripts/generator/fields/main_test.go @@ -126,6 +126,15 @@ func TestFieldsGenerator(t *testing.T) { &fieldYml{Name: "message", Description: "Please add description", Example: "Please add example", Type: "text"}, }, }, + FieldsGeneratorTestCase{ + patterns: []string{ + "\\[%{TIMESTAMP:timestamp}\\] %{NUMBER:idx:int}", + }, + fields: []*fieldYml{ + &fieldYml{Name: "timestamp", Description: "Please add description", Example: "Please add example", Type: "text"}, + &fieldYml{Name: "idx", Description: "Please add description", Example: "Please add example", Type: "int"}, + }, + }, } for _, tc := range tests { From c558984e29dc04340d1dc129f6020189d5d26466 Mon Sep 17 00:00:00 2001 From: Steffen Siering Date: Thu, 19 Jul 2018 09:21:50 +0200 Subject: [PATCH 07/34] Fix filebeat registry meta being nil vs empty (#7632) Filebeat introduces a meta field to registry entries in 6.3.1. The meta field is used to distuingish different log streams in docker files. For other input types the meta field must be null. Unfortunately the input loader did initialize the meta field with an empty dictionary. This leads to failing matches of old and new registry entries. Due to the match failing, old entries will not be removed, and filebeat will handle all files as new files on startup (old logs are send again). Users will observe duplicate entries in the reigstry file. One entry with "meta": null and one entry with "meta": {}. The entry with "meta": {} will be used by filebeat. The null-entry will not be used by filebeat, but is kept in the registry file, cause it has now active owner (yet). Improvements provided by this PR: * when matching states consider an empty map and a null-map to be equivalent * update input loader to create a null map for old state -> registry entries will be compatible on upgrade * Add checks in critical places replacing an empty map with a null-map * Add support to fix registry entries on load. states from corrupted 6.3.1 files will be merged into one single state on load * introduce unit tests for loading different registry formats * introduce system tests validating output and registry when upgrading filebeat from an older version Closes: #7634 --- CHANGELOG.asciidoc | 1 + filebeat/input/docker/input.go | 3 + filebeat/input/file/state.go | 7 +- filebeat/input/input.go | 2 +- filebeat/input/log/input.go | 11 +- filebeat/registrar/registrar.go | 104 +++++++++- filebeat/registrar/registrar_test.go | 189 ++++++++++++++++++ .../files/registry/test-2lines-registry-6.3.0 | 1 + .../files/registry/test-2lines-registry-6.3.1 | 1 + .../test-2lines-registry-6.3.1-faulty | 4 + .../registry/test-2lines-registry-latest | 1 + filebeat/tests/system/test_registrar.py | 1 + .../tests/system/test_registrar_upgrade.py | 86 ++++++++ 13 files changed, 401 insertions(+), 10 deletions(-) create mode 100644 filebeat/registrar/registrar_test.go create mode 100644 filebeat/tests/files/registry/test-2lines-registry-6.3.0 create mode 100644 filebeat/tests/files/registry/test-2lines-registry-6.3.1 create mode 100644 filebeat/tests/files/registry/test-2lines-registry-6.3.1-faulty create mode 100644 filebeat/tests/files/registry/test-2lines-registry-latest create mode 100644 filebeat/tests/system/test_registrar_upgrade.py diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index a533f1fbbf0a..519737a6ee74 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -103,6 +103,7 @@ https://github.com/elastic/beats/compare/v6.2.3...master[Check the HEAD diff] - Fix offset field pointing at end of a line. {issue}6514[6514] - Fix an issue when parsing ISO8601 dates with timezone definition {issue}7367[7367] - Fix Grok pattern of MongoDB module. {pull}7568[7568] +- Fix registry duplicates and log resending on upgrade. {issue}7634[7634] *Heartbeat* - Fix race due to updates of shared a map, that was not supposed to be shared between multiple go-routines. {issue}6616[6616] diff --git a/filebeat/input/docker/input.go b/filebeat/input/docker/input.go index e1b3eb49af7b..ce34276e5479 100644 --- a/filebeat/input/docker/input.go +++ b/filebeat/input/docker/input.go @@ -73,6 +73,9 @@ func NewInput( // Add stream to meta to ensure different state per stream if config.Containers.Stream != "all" { + if context.Meta == nil { + context.Meta = map[string]string{} + } context.Meta["stream"] = config.Containers.Stream } diff --git a/filebeat/input/file/state.go b/filebeat/input/file/state.go index 1f93a259f799..96c5abf2071f 100644 --- a/filebeat/input/file/state.go +++ b/filebeat/input/file/state.go @@ -44,6 +44,9 @@ type State struct { // NewState creates a new file state func NewState(fileInfo os.FileInfo, path string, t string, meta map[string]string) State { + if len(meta) == 0 { + meta = nil + } return State{ Fileinfo: fileInfo, Source: path, @@ -60,7 +63,7 @@ func NewState(fileInfo os.FileInfo, path string, t string, meta map[string]strin func (s *State) ID() string { // Generate id on first request. This is needed as id is not set when converting back from json if s.Id == "" { - if s.Meta == nil { + if len(s.Meta) == 0 { s.Id = s.FileStateOS.String() } else { hashValue, _ := hashstructure.Hash(s.Meta, nil) @@ -91,6 +94,6 @@ func (s *State) IsEqual(c *State) bool { func (s *State) IsEmpty() bool { return s.FileStateOS == file.StateOS{} && s.Source == "" && - s.Meta == nil && + len(s.Meta) == 0 && s.Timestamp.IsZero() } diff --git a/filebeat/input/input.go b/filebeat/input/input.go index 414d20963fe6..98eea51db8a5 100644 --- a/filebeat/input/input.go +++ b/filebeat/input/input.go @@ -96,7 +96,7 @@ func New( Done: input.done, BeatDone: input.beatDone, DynamicFields: dynFields, - Meta: map[string]string{}, + Meta: nil, } var ipt Input ipt, err = f(conf, outlet, context) diff --git a/filebeat/input/log/input.go b/filebeat/input/log/input.go index 6964b513c893..afba5fb42202 100644 --- a/filebeat/input/log/input.go +++ b/filebeat/input/log/input.go @@ -93,6 +93,11 @@ func NewInput( // can be forwarded correctly to the registrar. stateOut := channel.CloseOnSignal(channel.SubOutlet(out), context.BeatDone) + meta := context.Meta + if len(meta) == 0 { + meta = nil + } + p := &Input{ config: defaultConfig, cfg: cfg, @@ -101,7 +106,7 @@ func NewInput( stateOutlet: stateOut, states: file.NewStates(), done: context.Done, - meta: context.Meta, + meta: meta, } if err := cfg.Unpack(&p.config); err != nil { @@ -687,6 +692,10 @@ func (p *Input) updateState(state file.State) error { state.TTL = p.config.CleanInactive } + if len(state.Meta) == 0 { + state.Meta = nil + } + // Update first internal state p.states.Update(state) diff --git a/filebeat/registrar/registrar.go b/filebeat/registrar/registrar.go index 804ef5692034..5a2a6d0c1353 100644 --- a/filebeat/registrar/registrar.go +++ b/filebeat/registrar/registrar.go @@ -20,6 +20,7 @@ package registrar import ( "encoding/json" "fmt" + "io" "os" "path/filepath" "sync" @@ -132,20 +133,111 @@ func (r *Registrar) loadStates() error { logp.Info("Loading registrar data from %s", r.registryFile) - decoder := json.NewDecoder(f) - states := []file.State{} - err = decoder.Decode(&states) + states, err := readStatesFrom(f) if err != nil { - return fmt.Errorf("Error decoding states: %s", err) + return err } - - states = resetStates(states) r.states.SetStates(states) logp.Info("States Loaded from registrar: %+v", len(states)) return nil } +func readStatesFrom(in io.Reader) ([]file.State, error) { + states := []file.State{} + decoder := json.NewDecoder(in) + if err := decoder.Decode(&states); err != nil { + return nil, fmt.Errorf("Error decoding states: %s", err) + } + + states = fixStates(states) + states = resetStates(states) + return states, nil +} + +// fixStates cleans up the regsitry states when updating from an older version +// of filebeat potentially writing invalid entries. +func fixStates(states []file.State) []file.State { + if len(states) == 0 { + return states + } + + // we use a map of states here, so to identify and merge duplicate entries. + idx := map[string]*file.State{} + for i := range states { + state := &states[i] + fixState(state) + + id := state.ID() + old, exists := idx[id] + if !exists { + idx[id] = state + } else { + mergeStates(old, state) // overwrite the entry in 'old' + } + } + + if len(idx) == len(states) { + return states + } + + i := 0 + newStates := make([]file.State, len(idx)) + for _, state := range idx { + newStates[i] = *state + i++ + } + return newStates +} + +// fixState updates a read state to fullfil required invariantes: +// - "Meta" must be nil if len(Meta) == 0 +func fixState(st *file.State) { + if len(st.Meta) == 0 { + st.Meta = nil + } +} + +// mergeStates merges 2 states by trying to determine the 'newer' state. +// The st state is overwritten with the updated fields. +func mergeStates(st, other *file.State) { + st.Finished = st.Finished || other.Finished + if st.Offset < other.Offset { // always select the higher offset + st.Offset = other.Offset + } + + // update file meta-data. As these are updated concurrently by the + // prospectors, select the newer state based on the update timestamp. + var meta, metaOld, metaNew map[string]string + if st.Timestamp.Before(other.Timestamp) { + st.Source = other.Source + st.Timestamp = other.Timestamp + st.TTL = other.TTL + st.FileStateOS = other.FileStateOS + + metaOld, metaNew = st.Meta, other.Meta + } else { + metaOld, metaNew = other.Meta, st.Meta + } + + if len(metaOld) == 0 || len(metaNew) == 0 { + meta = metaNew + } else { + meta = map[string]string{} + for k, v := range metaOld { + meta[k] = v + } + for k, v := range metaNew { + meta[k] = v + } + } + + if len(meta) == 0 { + meta = nil + } + st.Meta = meta +} + // resetStates sets all states to finished and disable TTL on restart // For all states covered by an input, TTL will be overwritten with the input value func resetStates(states []file.State) []file.State { diff --git a/filebeat/registrar/registrar_test.go b/filebeat/registrar/registrar_test.go new file mode 100644 index 000000000000..102b073dffad --- /dev/null +++ b/filebeat/registrar/registrar_test.go @@ -0,0 +1,189 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package registrar + +import ( + "reflect" + "sort" + "strings" + "testing" + "time" + + "github.com/stretchr/testify/assert" + + "github.com/elastic/beats/filebeat/input/file" +) + +func TestRegistrarRead(t *testing.T) { + type testCase struct { + input string + expected []file.State + } + + zone := time.FixedZone("+0000", 0) + + cases := map[string]testCase{ + "ok registry with one entry": testCase{ + input: `[ + { + "type": "log", + "source": "test.log", + "offset": 10, + "timestamp": "2018-07-16T10:45:01+00:00", + "ttl": -1, + "meta": null + } + ]`, + expected: []file.State{ + { + Type: "log", + Source: "test.log", + Timestamp: time.Date(2018, time.July, 16, 10, 45, 01, 0, zone), + Offset: 10, + TTL: -2, // loader always resets states + }, + }, + }, + + "load config without meta": testCase{ + input: `[ + { + "type": "log", + "source": "test.log", + "offset": 10, + "timestamp": "2018-07-16T10:45:01+00:00", + "ttl": -1 + } + ]`, + expected: []file.State{ + { + Type: "log", + Source: "test.log", + Timestamp: time.Date(2018, time.July, 16, 10, 45, 01, 0, zone), + Offset: 10, + TTL: -2, // loader always resets states + }, + }, + }, + + "load config with empty meta": testCase{ + input: `[ + { + "type": "log", + "source": "test.log", + "offset": 10, + "timestamp": "2018-07-16T10:45:01+00:00", + "ttl": -1, + "meta": {} + } + ]`, + expected: []file.State{ + { + Type: "log", + Source: "test.log", + Timestamp: time.Date(2018, time.July, 16, 10, 45, 01, 0, zone), + Offset: 10, + TTL: -2, // loader always resets states + }, + }, + }, + + "requires merge without meta-data": testCase{ + input: `[ + { + "type": "log", + "source": "test.log", + "offset": 100, + "timestamp": "2018-07-16T10:45:01+00:00", + "ttl": -1, + "meta": {} + }, + { + "type": "log", + "source": "test.log", + "offset": 10, + "timestamp": "2018-07-16T10:45:10+00:00", + "ttl": -1, + "meta": null + } + ]`, + expected: []file.State{ + { + Type: "log", + Source: "test.log", + Timestamp: time.Date(2018, time.July, 16, 10, 45, 10, 0, zone), + Offset: 100, + TTL: -2, // loader always resets states + Meta: nil, + }, + }, + }, + } + + matchState := func(t *testing.T, i int, expected, actual file.State) { + check := func(name string, a, b interface{}) { + if !reflect.DeepEqual(a, b) { + t.Errorf("State %v: %v mismatch (expected=%v, actual=%v)", i, name, a, b) + } + } + + check("id", expected.ID(), actual.ID()) + check("source", expected.Source, actual.Source) + check("offset", expected.Offset, actual.Offset) + check("ttl", expected.TTL, actual.TTL) + check("meta", expected.Meta, actual.Meta) + check("type", expected.Type, actual.Type) + + if t1, t2 := expected.Timestamp, actual.Timestamp; !t1.Equal(t2) { + t.Errorf("State %v: timestamp mismatch (expected=%v, actual=%v)", i, t1, t2) + } + } + + for name, test := range cases { + test := test + t.Run(name, func(t *testing.T) { + in := strings.NewReader(test.input) + + states, err := readStatesFrom(in) + if !assert.NoError(t, err) { + return + } + + actual := sortedStates(states) + expected := sortedStates(test.expected) + if len(actual) != len(expected) { + t.Errorf("expected %v state, but registrar did load %v states", + len(expected), len(actual)) + return + } + + for i := range expected { + matchState(t, i, expected[i], actual[i]) + } + }) + } +} + +func sortedStates(states []file.State) []file.State { + tmp := make([]file.State, len(states)) + copy(tmp, states) + sort.Slice(tmp, func(i, j int) bool { + return tmp[i].ID() < tmp[j].ID() + }) + return tmp +} diff --git a/filebeat/tests/files/registry/test-2lines-registry-6.3.0 b/filebeat/tests/files/registry/test-2lines-registry-6.3.0 new file mode 100644 index 000000000000..5f7414b9cf3a --- /dev/null +++ b/filebeat/tests/files/registry/test-2lines-registry-6.3.0 @@ -0,0 +1 @@ +[{"source":"test.log","offset":10,"timestamp":"2018-07-18T21:51:43.529893808+02:00","ttl":-1,"type":"log","FileStateOS":{"inode":8604592318,"device":16777220}}] diff --git a/filebeat/tests/files/registry/test-2lines-registry-6.3.1 b/filebeat/tests/files/registry/test-2lines-registry-6.3.1 new file mode 100644 index 000000000000..a4c2ccf126c6 --- /dev/null +++ b/filebeat/tests/files/registry/test-2lines-registry-6.3.1 @@ -0,0 +1 @@ +[{"source":"test.log","offset":10,"timestamp":"2018-07-18T21:51:43.529893808+02:00","ttl":-1,"type":"log","meta":{},"FileStateOS":{"inode":8604592318,"device":16777220}}] diff --git a/filebeat/tests/files/registry/test-2lines-registry-6.3.1-faulty b/filebeat/tests/files/registry/test-2lines-registry-6.3.1-faulty new file mode 100644 index 000000000000..2606e69bbbc3 --- /dev/null +++ b/filebeat/tests/files/registry/test-2lines-registry-6.3.1-faulty @@ -0,0 +1,4 @@ +[ + {"source":"test.log","offset":10,"timestamp":"2018-07-18T21:51:43.529893808+02:00","ttl":-1,"type":"log","meta":{},"FileStateOS":{"inode":8604592318,"device":16777220}}, + {"source":"test.log","offset":0,"timestamp":"2018-07-18T21:51:43.529893808+02:00","ttl":-1,"type":"log","meta":null,"FileStateOS":{"inode":8604592318,"device":16777220}} +] diff --git a/filebeat/tests/files/registry/test-2lines-registry-latest b/filebeat/tests/files/registry/test-2lines-registry-latest new file mode 100644 index 000000000000..110dc1613d1b --- /dev/null +++ b/filebeat/tests/files/registry/test-2lines-registry-latest @@ -0,0 +1 @@ +[{"source":"test.log","offset":10,"timestamp":"2018-07-18T21:51:43.529893808+02:00","ttl":-1,"type":"log","meta":null,"FileStateOS":{"inode":8604592318,"device":16777220}}] diff --git a/filebeat/tests/system/test_registrar.py b/filebeat/tests/system/test_registrar.py index 73d303245232..dd74266fa815 100644 --- a/filebeat/tests/system/test_registrar.py +++ b/filebeat/tests/system/test_registrar.py @@ -70,6 +70,7 @@ def test_registrar_file_content(self): "offset": iterations * line_len, }, record) self.assertTrue("FileStateOS" in record) + self.assertIsNone(record["meta"]) file_state_os = record["FileStateOS"] if os.name == "nt": diff --git a/filebeat/tests/system/test_registrar_upgrade.py b/filebeat/tests/system/test_registrar_upgrade.py new file mode 100644 index 000000000000..21569e9c384a --- /dev/null +++ b/filebeat/tests/system/test_registrar_upgrade.py @@ -0,0 +1,86 @@ +#!/usr/bin/env python +"""Test the registrar with old registry file formats""" + +import os +import json + +from nose.plugins.skip import Skip, SkipTest + +from filebeat import BaseTest + + +class Test(BaseTest): + def test_upgrade_from_6_3_0(self): + template = "test-2lines-registry-6.3.0" + self.run_with_single_registry_format(template) + + def test_upgrade_from_6_3_1(self): + template = "test-2lines-registry-6.3.1" + self.run_with_single_registry_format(template) + + def test_upgrade_from_faulty_6_3_1(self): + template = "test-2lines-registry-6.3.1-faulty" + self.run_with_single_registry_format(template) + + def test_upgrade_from_latest(self): + template = "test-2lines-registry-latest" + self.run_with_single_registry_format(template) + + def run_with_single_registry_format(self, template): + # prepare log file + testfile, file_state = self.prepare_log() + + # prepare registry file + self.apply_registry_template(template, testfile, file_state) + + self.run_and_validate() + + def apply_registry_template(self, template, testfile, file_state): + source = self.beat_path + "/tests/files/registry/" + template + with open(source) as f: + registry = json.loads(f.read()) + + for state in registry: + state["source"] = testfile + state["FileStateOS"] = file_state + with open(self.working_dir + "/registry", 'w') as f: + f.write(json.dumps(registry)) + + def prepare_log(self): + # test is current skipped on windows, due to FileStateOS must match the + # current OS format. + if os.name == "nt": + raise SkipTest + + self.render_config_template( + path=os.path.abspath(self.working_dir) + "/log/*" + ) + + os.mkdir(self.working_dir + "/log/") + + testfile_path = self.working_dir + "/log/test.log" + with open(testfile_path, 'w') as f: + f.write("123456789\n") + f.write("abcdefghi\n") + + st = os.stat(testfile_path) + file_state = {"inode": st.st_ino, "device": st.st_dev} + return testfile_path, file_state + + def run_and_validate(self): + filebeat = self.start_beat() + self.wait_until( + lambda: self.output_has(lines=1), + max_timeout=15) + + # stop filebeat and enforce one last registry update + filebeat.check_kill_and_wait() + + data = self.get_registry() + assert len(data) == 1 + assert data[0]["offset"] == 20 + + # check only second line has been written + output = self.read_output() + assert len(output) == 1 + assert output[0]["message"] == "abcdefghi" From efb1b2a34bc55e846c5b106343a94fa89a7ce21b Mon Sep 17 00:00:00 2001 From: Andrew Cholakian Date: Thu, 19 Jul 2018 08:14:00 -0500 Subject: [PATCH 08/34] Heartbeat Job Validation + addition of libbeat/mapval (#7587) This commit seeks to establish a pattern for testing heartbeat jobs. It currently tests the HTTP and TCP jobs. It also required some minor refactors of those tasks for HTTP/TCP. To do this, it made sense to validate event maps with a sort of schema library. I couldn't find one that did exactly what I wanted here, so I wrote one called mapval. That turned out to be a large undertaking, and is now the majority of this commit. Further tests need to be written, but this commit is large enough as is. One of the nicest things about the heartbeat architecture is the dialer chain behavior. It should be the case that any validated protocol using TCP (e.g. HTTP, TCP, Redis, etc.) has the exact same tcp metadata. To help make testing these properties easy mapval lets users compose portions of a schema into a bigger one. In other words, you can say "An HTTP response should be a TCP response, with the standard monitor data added in, and also the special HTTP fields". Even having only written a handful of tests this has uncovered some inconsistencies there, where TCP jobs have a hostname, but HTTP ones do not. --- heartbeat/hbtest/hbtestutil.go | 90 ++ heartbeat/monitors/active/http/http_test.go | 105 ++ heartbeat/monitors/active/http/task.go | 48 +- heartbeat/monitors/active/http/task_test.go | 88 +- heartbeat/monitors/active/tcp/tcp_test.go | 73 + libbeat/common/mapval/core.go | 143 ++ libbeat/common/mapval/core_test.go | 207 +++ libbeat/common/mapval/is_defs.go | 103 ++ libbeat/common/mapval/results.go | 93 ++ libbeat/common/mapval/value.go | 69 + libbeat/common/mapval/walk.go | 73 + libbeat/testing/mapvaltest/mapvaltest.go | 39 + libbeat/testing/mapvaltest/mapvaltest_test.go | 41 + .../stretchr/testify/require/doc.go | 28 + .../testify/require/forward_requirements.go | 16 + .../stretchr/testify/require/require.go | 1227 +++++++++++++++++ .../stretchr/testify/require/require.go.tmpl | 6 + .../testify/require/require_forward.go | 957 +++++++++++++ .../testify/require/require_forward.go.tmpl | 5 + .../stretchr/testify/require/requirements.go | 29 + vendor/vendor.json | 6 + 21 files changed, 3413 insertions(+), 33 deletions(-) create mode 100644 heartbeat/hbtest/hbtestutil.go create mode 100644 heartbeat/monitors/active/http/http_test.go create mode 100644 heartbeat/monitors/active/tcp/tcp_test.go create mode 100644 libbeat/common/mapval/core.go create mode 100644 libbeat/common/mapval/core_test.go create mode 100644 libbeat/common/mapval/is_defs.go create mode 100644 libbeat/common/mapval/results.go create mode 100644 libbeat/common/mapval/value.go create mode 100644 libbeat/common/mapval/walk.go create mode 100644 libbeat/testing/mapvaltest/mapvaltest.go create mode 100644 libbeat/testing/mapvaltest/mapvaltest_test.go create mode 100644 vendor/github.com/stretchr/testify/require/doc.go create mode 100644 vendor/github.com/stretchr/testify/require/forward_requirements.go create mode 100644 vendor/github.com/stretchr/testify/require/require.go create mode 100644 vendor/github.com/stretchr/testify/require/require.go.tmpl create mode 100644 vendor/github.com/stretchr/testify/require/require_forward.go create mode 100644 vendor/github.com/stretchr/testify/require/require_forward.go.tmpl create mode 100644 vendor/github.com/stretchr/testify/require/requirements.go diff --git a/heartbeat/hbtest/hbtestutil.go b/heartbeat/hbtest/hbtestutil.go new file mode 100644 index 000000000000..006b878b4426 --- /dev/null +++ b/heartbeat/hbtest/hbtestutil.go @@ -0,0 +1,90 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package hbtest + +import ( + "io" + "net/http" + "net/url" + "strconv" + + "net/http/httptest" + + "github.com/elastic/beats/libbeat/common/mapval" +) + +// HelloWorldBody is the body of the HelloWorldHandler. +const HelloWorldBody = "hello, world!" + +// HelloWorldHandler is a handler for an http server that returns +// HelloWorldBody and a 200 OK status. +var HelloWorldHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.WriteHeader(http.StatusOK) + io.WriteString(w, HelloWorldBody) +}) + +// BadGatewayBody is the body of the BadGatewayHandler. +const BadGatewayBody = "Bad Gateway" + +// BadGatewayHandler is a handler for an http server that returns +// BadGatewayBody and a 200 OK status. +var BadGatewayHandler = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) { + w.WriteHeader(http.StatusBadGateway) + io.WriteString(w, BadGatewayBody) +}) + +// ServerPort takes an httptest.Server and returns its port as a uint16. +func ServerPort(server *httptest.Server) (uint16, error) { + u, err := url.Parse(server.URL) + if err != nil { + return 0, err + } + p, err := strconv.Atoi(u.Port()) + if err != nil { + return 0, err + } + return uint16(p), nil +} + +// MonitorChecks creates a skima.Validator that represents the "monitor" field present +// in all heartbeat events. +func MonitorChecks(id string, host string, ip string, scheme string, status string) mapval.Validator { + return mapval.Schema(mapval.Map{ + "monitor": mapval.Map{ + // TODO: This is only optional because, for some reason, TCP returns + // this value, but HTTP does not. We should fix this + "host": mapval.Optional(mapval.IsEqual(host)), + "duration.us": mapval.IsDuration, + "id": id, + "ip": ip, + "scheme": scheme, + "status": status, + }, + }) +} + +// TCPChecks creates a skima.Validator that represents the "tcp" field present +// in all heartbeat events that use a Tcp connection as part of their DialChain +func TCPChecks(port uint16) mapval.Validator { + return mapval.Schema(mapval.Map{ + "tcp": mapval.Map{ + "port": port, + "rtt.connect.us": mapval.IsDuration, + }, + }) +} diff --git a/heartbeat/monitors/active/http/http_test.go b/heartbeat/monitors/active/http/http_test.go new file mode 100644 index 000000000000..4f30289554d1 --- /dev/null +++ b/heartbeat/monitors/active/http/http_test.go @@ -0,0 +1,105 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package http + +import ( + "net/http" + "net/http/httptest" + "testing" + + "github.com/stretchr/testify/require" + + "github.com/elastic/beats/heartbeat/hbtest" + "github.com/elastic/beats/heartbeat/monitors" + "github.com/elastic/beats/libbeat/beat" + "github.com/elastic/beats/libbeat/common" + "github.com/elastic/beats/libbeat/common/mapval" + "github.com/elastic/beats/libbeat/testing/mapvaltest" +) + +func checkServer(t *testing.T, handlerFunc http.HandlerFunc) (*httptest.Server, beat.Event) { + server := httptest.NewServer(handlerFunc) + defer server.Close() + + config := common.NewConfig() + config.SetString("urls", 0, server.URL) + + jobs, err := create(monitors.Info{}, config) + require.NoError(t, err) + + job := jobs[0] + + event, _, err := job.Run() + require.NoError(t, err) + + return server, event +} + +func httpChecks(urlStr string, statusCode int) mapval.Validator { + return mapval.Schema(mapval.Map{ + "http": mapval.Map{ + "url": urlStr, + "response.status_code": statusCode, + "rtt.content.us": mapval.IsDuration, + "rtt.response_header.us": mapval.IsDuration, + "rtt.total.us": mapval.IsDuration, + "rtt.validate.us": mapval.IsDuration, + "rtt.write_request.us": mapval.IsDuration, + }, + }) +} + +func badGatewayChecks() mapval.Validator { + return mapval.Schema(mapval.Map{ + "error": mapval.Map{ + "message": "502 Bad Gateway", + "type": "validate", + }, + }) +} + +func TestOKJob(t *testing.T) { + server, event := checkServer(t, hbtest.HelloWorldHandler) + port, err := hbtest.ServerPort(server) + require.NoError(t, err) + + mapvaltest.Test( + t, + mapval.Strict(mapval.Compose( + hbtest.MonitorChecks("http@"+server.URL, server.URL, "127.0.0.1", "http", "up"), + hbtest.TCPChecks(port), + httpChecks(server.URL, http.StatusOK), + ))(event.Fields), + ) +} + +func TestBadGatewayJob(t *testing.T) { + server, event := checkServer(t, hbtest.BadGatewayHandler) + port, err := hbtest.ServerPort(server) + require.NoError(t, err) + + mapvaltest.Test( + t, + mapval.Strict(mapval.Compose( + hbtest.MonitorChecks("http@"+server.URL, server.URL, "127.0.0.1", "http", "down"), + hbtest.TCPChecks(port), + httpChecks(server.URL, http.StatusBadGateway), + badGatewayChecks(), + ))(event.Fields), + ) +} diff --git a/heartbeat/monitors/active/http/task.go b/heartbeat/monitors/active/http/task.go index 86f4716be52f..c1f02ce87e43 100644 --- a/heartbeat/monitors/active/http/task.go +++ b/heartbeat/monitors/active/http/task.go @@ -218,29 +218,58 @@ func execPing( body []byte, timeout time.Duration, validator func(*http.Response) error, -) (time.Time, time.Time, common.MapStr, reason.Reason) { +) (start, end time.Time, event common.MapStr, errReason reason.Reason) { ctx, cancel := context.WithTimeout(context.Background(), timeout) defer cancel() - req = req.WithContext(ctx) + req = attachRequestBody(&ctx, req, body) + start, end, resp, errReason := execRequest(client, req, validator) + + if errReason != nil { + if resp != nil { + return start, end, makeEvent(end.Sub(start), resp), errReason + } + return start, end, nil, errReason + } + + event = makeEvent(end.Sub(start), resp) + + return start, end, event, nil +} + +func attachRequestBody(ctx *context.Context, req *http.Request, body []byte) *http.Request { + req = req.WithContext(*ctx) if len(body) > 0 { req.Body = ioutil.NopCloser(bytes.NewBuffer(body)) req.ContentLength = int64(len(body)) } - start := time.Now() + return req +} + +func execRequest(client *http.Client, req *http.Request, validator func(*http.Response) error) (start time.Time, end time.Time, resp *http.Response, errReason reason.Reason) { + start = time.Now() resp, err := client.Do(req) - end := time.Now() + if resp != nil { // If above errors, the response will be nil + defer resp.Body.Close() + } + end = time.Now() + if err != nil { return start, end, nil, reason.IOFailed(err) } - defer resp.Body.Close() err = validator(resp) end = time.Now() + if err != nil { + return start, end, resp, reason.ValidateFailed(err) + } + + return start, end, resp, nil +} - rtt := end.Sub(start) - event := common.MapStr{"http": common.MapStr{ +func makeEvent(rtt time.Duration, resp *http.Response) common.MapStr { + return common.MapStr{"http": common.MapStr{ "response": common.MapStr{ "status_code": resp.StatusCode, }, @@ -248,11 +277,6 @@ func execPing( "total": look.RTT(rtt), }, }} - - if err != nil { - return start, end, event, reason.ValidateFailed(err) - } - return start, end, event, nil } func splitHostnamePort(requ *http.Request) (string, uint16, error) { diff --git a/heartbeat/monitors/active/http/task_test.go b/heartbeat/monitors/active/http/task_test.go index 1b5f3756b441..7e82eb4865ba 100644 --- a/heartbeat/monitors/active/http/task_test.go +++ b/heartbeat/monitors/active/http/task_test.go @@ -23,10 +23,13 @@ import ( "net/url" "reflect" "testing" + + "github.com/stretchr/testify/assert" ) func TestSplitHostnamePort(t *testing.T) { var urlTests = []struct { + name string scheme string host string expectedHost string @@ -34,6 +37,7 @@ func TestSplitHostnamePort(t *testing.T) { expectedError error }{ { + "plain", "http", "foo", "foo", @@ -41,6 +45,7 @@ func TestSplitHostnamePort(t *testing.T) { nil, }, { + "dotted domain", "http", "www.foo.com", "www.foo.com", @@ -48,6 +53,7 @@ func TestSplitHostnamePort(t *testing.T) { nil, }, { + "dotted domain, custom port", "http", "www.foo.com:8080", "www.foo.com", @@ -55,6 +61,7 @@ func TestSplitHostnamePort(t *testing.T) { nil, }, { + "https plain", "https", "foo", "foo", @@ -62,6 +69,7 @@ func TestSplitHostnamePort(t *testing.T) { nil, }, { + "custom port", "http", "foo:81", "foo", @@ -69,6 +77,7 @@ func TestSplitHostnamePort(t *testing.T) { nil, }, { + "https custom port", "https", "foo:444", "foo", @@ -76,6 +85,7 @@ func TestSplitHostnamePort(t *testing.T) { nil, }, { + "bad scheme", "httpz", "foo", "foo", @@ -84,27 +94,63 @@ func TestSplitHostnamePort(t *testing.T) { }, } for _, test := range urlTests { - url := &url.URL{ - Scheme: test.scheme, - Host: test.host, - } - request := &http.Request{ - URL: url, - } - host, port, err := splitHostnamePort(request) - if err != nil { - if test.expectedError == nil { - t.Error(err) - } else if reflect.TypeOf(err) != reflect.TypeOf(test.expectedError) { - t.Errorf("Expected %T but got %T", err, test.expectedError) + test := test + + t.Run(test.name, func(t *testing.T) { + url := &url.URL{ + Scheme: test.scheme, + Host: test.host, + } + request := &http.Request{ + URL: url, + } + host, port, err := splitHostnamePort(request) + + if err != nil { + if test.expectedError == nil { + t.Error(err) + } else if reflect.TypeOf(err) != reflect.TypeOf(test.expectedError) { + t.Errorf("Expected %T but got %T", err, test.expectedError) + } + } else { + if host != test.expectedHost { + t.Errorf("Unexpected host for %#v: expected %q, got %q", request, test.expectedHost, host) + } + if port != test.expectedPort { + t.Errorf("Unexpected port for %#v: expected %q, got %q", request, test.expectedPort, port) + } } - continue - } - if host != test.expectedHost { - t.Errorf("Unexpected host for %#v: expected %q, got %q", request, test.expectedHost, host) - } - if port != test.expectedPort { - t.Errorf("Unexpected port for %#v: expected %q, got %q", request, test.expectedPort, port) - } + + }) + } +} + +func makeTestHTTPRequest(t *testing.T) *http.Request { + req, err := http.NewRequest("GET", "http://example.net", nil) + assert.Nil(t, err) + return req +} + +func TestZeroMaxRedirectShouldError(t *testing.T) { + checker := makeCheckRedirect(0) + req := makeTestHTTPRequest(t) + + res := checker(req, nil) + assert.Equal(t, http.ErrUseLastResponse, res) +} + +func TestNonZeroRedirect(t *testing.T) { + limit := 5 + checker := makeCheckRedirect(limit) + + var via []*http.Request + // Test requests within the limit + for i := 0; i < limit; i++ { + req := makeTestHTTPRequest(t) + assert.Nil(t, checker(req, via)) + via = append(via, req) } + + // We are now at the limit, this request should fail + assert.Equal(t, http.ErrUseLastResponse, checker(makeTestHTTPRequest(t), via)) } diff --git a/heartbeat/monitors/active/tcp/tcp_test.go b/heartbeat/monitors/active/tcp/tcp_test.go new file mode 100644 index 000000000000..d564801a6f9f --- /dev/null +++ b/heartbeat/monitors/active/tcp/tcp_test.go @@ -0,0 +1,73 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package tcp + +import ( + "fmt" + "net/http/httptest" + "testing" + + "github.com/stretchr/testify/require" + + "github.com/elastic/beats/heartbeat/hbtest" + "github.com/elastic/beats/heartbeat/monitors" + "github.com/elastic/beats/libbeat/common" + "github.com/elastic/beats/libbeat/common/mapval" + "github.com/elastic/beats/libbeat/testing/mapvaltest" +) + +func TestUpEndpoint(t *testing.T) { + server := httptest.NewServer(hbtest.HelloWorldHandler) + defer server.Close() + + port, err := hbtest.ServerPort(server) + require.NoError(t, err) + + config := common.NewConfig() + config.SetString("hosts", 0, "localhost") + config.SetInt("ports", 0, int64(port)) + + jobs, err := create(monitors.Info{}, config) + require.NoError(t, err) + + job := jobs[0] + + event, _, err := job.Run() + require.NoError(t, err) + + mapvaltest.Test( + t, + mapval.Strict(mapval.Compose( + hbtest.MonitorChecks( + fmt.Sprintf("tcp-tcp@localhost:%d", port), + "localhost", + "127.0.0.1", + "tcp", + "up", + ), + hbtest.TCPChecks(port), + mapval.Schema(mapval.Map{ + "resolve": mapval.Map{ + "host": "localhost", + "ip": "127.0.0.1", + "rtt.us": mapval.IsDuration, + }, + }), + ))(event.Fields), + ) +} diff --git a/libbeat/common/mapval/core.go b/libbeat/common/mapval/core.go new file mode 100644 index 000000000000..c8ae21de80ed --- /dev/null +++ b/libbeat/common/mapval/core.go @@ -0,0 +1,143 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package mapval + +import ( + "sort" + "strings" + + "github.com/elastic/beats/libbeat/common" +) + +// Is creates a named IsDef with the given checker. +func Is(name string, checker ValueValidator) IsDef { + return IsDef{name: name, checker: checker} +} + +// Optional wraps an IsDef to mark the field's presence as optional. +func Optional(id IsDef) IsDef { + id.name = "optional " + id.name + id.optional = true + return id +} + +// Map is the type used to define schema definitions for Schema. +type Map map[string]interface{} + +// Validator is the result of Schema and is run against the map you'd like to test. +type Validator func(common.MapStr) Results + +// Compose combines multiple SchemaValidators into a single one. +func Compose(validators ...Validator) Validator { + return func(actual common.MapStr) Results { + results := make([]Results, len(validators)) + for idx, validator := range validators { + results[idx] = validator(actual) + } + + combined := Results{} + for _, r := range results { + r.EachResult(func(path string, vr ValueResult) bool { + combined.recordResult(path, vr) + return true + }) + } + return combined + } +} + +// Strict is used when you want any unspecified keys that are encountered to be considered errors. +func Strict(laxValidator Validator) Validator { + return func(actual common.MapStr) Results { + validatedResults := laxValidator(actual) + + // The inner workings of this are a little weird + // We use a hash of dotted paths to track the results + // We can check if a key had a test associated with it by looking up the laxValidator + // result data + // What's trickier is intermediate maps, maps don't usually have explicit tests, they usually just have + // their properties tested. + // This method counts an intermediate map as tested if a subkey is tested. + // Since the datastructure we have to search is a flattened hashmap of the original map we take that hashmap + // and turn it into a sorted string array, then do a binary prefix search to determine if a subkey was tested. + // It's a little weird, but is fairly efficient. We could stop using the flattened map as a datastructure, but + // that would add complexity elsewhere. Probably a good refactor at some point, but not worth it now. + validatedPaths := []string{} + for k := range validatedResults { + validatedPaths = append(validatedPaths, k) + } + sort.Strings(validatedPaths) + + walk(actual, func(woi walkObserverInfo) { + _, validatedExactly := validatedResults[woi.dottedPath] + if validatedExactly { + return // This key was tested, passes strict test + } + + // Search returns the point just before an actual match (since we ruled out an exact match with the cheaper + // hash check above. We have to validate the actual match with a prefix check as well + matchIdx := sort.SearchStrings(validatedPaths, woi.dottedPath) + if matchIdx < len(validatedPaths) && strings.HasPrefix(validatedPaths[matchIdx], woi.dottedPath) { + return + } + + validatedResults.recordResult(woi.dottedPath, StrictFailureVR) + }) + + return validatedResults + } +} + +// Schema takes a Map and returns an executable Validator function. +func Schema(expected Map) Validator { + return func(actual common.MapStr) Results { + return walkValidate(expected, actual) + } +} + +func walkValidate(expected Map, actual common.MapStr) (results Results) { + results = Results{} + walk( + common.MapStr(expected), + func(expInfo walkObserverInfo) { + + actualKeyExists, _ := actual.HasKey(expInfo.dottedPath) + actualV, _ := actual.GetValue(expInfo.dottedPath) + + // If this is a definition use it, if not, check exact equality + isDef, isIsDef := expInfo.value.(IsDef) + if !isIsDef { + // We don't check maps for equality, we check their properties + // individual via our own traversal, so bail early + if _, isMS := actualV.(common.MapStr); isMS { + return + } + + isDef = IsEqual(expInfo.value) + } + + if !isDef.optional || isDef.optional && actualKeyExists { + results.recordResult( + expInfo.dottedPath, + isDef.check(actualV, actualKeyExists), + ) + } + }) + + return results +} diff --git a/libbeat/common/mapval/core_test.go b/libbeat/common/mapval/core_test.go new file mode 100644 index 000000000000..d3ed44b31323 --- /dev/null +++ b/libbeat/common/mapval/core_test.go @@ -0,0 +1,207 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package mapval + +import ( + "testing" + "time" + + "github.com/stretchr/testify/assert" + + "github.com/elastic/beats/libbeat/common" +) + +// assertResults validates the schema passed successfully. +func assertResults(t *testing.T, r Results) Results { + for _, err := range r.Errors() { + assert.NoError(t, err) + } + return r +} + +func TestFlat(t *testing.T) { + m := common.MapStr{ + "foo": "bar", + "baz": 1, + } + + results := Schema(Map{ + "foo": "bar", + "baz": IsIntGt(0), + })(m) + + assertResults(t, results) +} + +func TestBadFlat(t *testing.T) { + m := common.MapStr{} + + fakeT := new(testing.T) + + results := Schema(Map{ + "notafield": IsDuration, + })(m) + + assertResults(fakeT, results) + assert.True(t, fakeT.Failed()) + + result := results["notafield"][0] + assert.False(t, result.Valid) + assert.Equal(t, result.Message, KeyMissingVR.Message) +} + +func TestNested(t *testing.T) { + m := common.MapStr{ + "foo": common.MapStr{ + "bar": "baz", + "dur": time.Duration(100), + }, + } + + results := Schema(Map{ + "foo": Map{ + "bar": "baz", + }, + "foo.dur": IsDuration, + })(m) + + assertResults(t, results) + + assert.Len(t, results, 2, "One result per matcher") +} + +func TestComposition(t *testing.T) { + m := common.MapStr{ + "foo": "bar", + "baz": "bot", + } + + fooValidator := Schema(Map{"foo": "bar"}) + bazValidator := Schema(Map{"baz": "bot"}) + composed := Compose(fooValidator, bazValidator) + + // Test that the validators work individually + assertResults(t, fooValidator(m)) + assertResults(t, bazValidator(m)) + + // Test that the composition of them works + assertResults(t, composed(m)) + + assert.Len(t, composed(m), 2) + + badValidator := Schema(Map{"notakey": "blah"}) + badComposed := Compose(badValidator, composed) + + fakeT := new(testing.T) + assertResults(fakeT, badComposed(m)) + assert.Len(t, badComposed(m), 3) + assert.True(t, fakeT.Failed()) +} + +func TestStrictFunc(t *testing.T) { + m := common.MapStr{ + "foo": "bar", + "baz": "bot", + "nest": common.MapStr{ + "very": common.MapStr{ + "deep": "true", + }, + }, + } + + validValidator := Schema(Map{ + "foo": "bar", + "baz": "bot", + "nest": Map{ + "very": Map{ + "deep": "true", + }, + }, + }) + + assertResults(t, validValidator(m)) + + partialValidator := Schema(Map{ + "foo": "bar", + }) + + // Should pass, since this is not a strict check + assertResults(t, partialValidator(m)) + + res := Strict(partialValidator)(m) + assert.Equal(t, []ValueResult{StrictFailureVR}, res.DetailedErrors()["baz"]) + assert.Equal(t, []ValueResult{StrictFailureVR}, res.DetailedErrors()["nest.very.deep"]) + assert.Nil(t, res.DetailedErrors()["bar"]) + assert.False(t, res.Valid()) +} + +func TestOptional(t *testing.T) { + m := common.MapStr{ + "foo": "bar", + } + + validator := Schema(Map{ + "non": Optional(IsEqual("foo")), + }) + + assertResults(t, validator(m)) +} + +func TestExistence(t *testing.T) { + m := common.MapStr{ + "exists": "foo", + } + + validator := Schema(Map{ + "exists": KeyPresent, + "non": KeyMissing, + }) + + assertResults(t, validator(m)) +} + +func TestComplex(t *testing.T) { + m := common.MapStr{ + "foo": "bar", + "hash": common.MapStr{ + "baz": 1, + "bot": 2, + "deep_hash": common.MapStr{ + "qux": "quark", + }, + }, + "slice": []string{"pizza", "pasta", "and more"}, + "empty": nil, + } + + res := Schema(Map{ + "foo": "bar", + "hash": Map{ + "baz": 1, + "bot": 2, + "deep_hash": Map{ + "qux": "quark", + }, + }, + "slice": []string{"pizza", "pasta", "and more"}, + "empty": KeyPresent, + "doesNotExist": KeyMissing, + })(m) + + assertResults(t, res) +} diff --git a/libbeat/common/mapval/is_defs.go b/libbeat/common/mapval/is_defs.go new file mode 100644 index 000000000000..9525533c598b --- /dev/null +++ b/libbeat/common/mapval/is_defs.go @@ -0,0 +1,103 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package mapval + +import ( + "fmt" + "time" + + "github.com/stretchr/testify/assert" +) + +// KeyPresent checks that the given key is in the map, even if it has a nil value. +var KeyPresent = IsDef{name: "check key present"} + +// KeyMissing checks that the given key is not present defined. +var KeyMissing = IsDef{name: "check key not present", checkKeyMissing: true} + +// IsDuration tests that the given value is a duration. +var IsDuration = Is("is a duration", func(v interface{}) ValueResult { + if _, ok := v.(time.Duration); ok { + return ValidVR + } + return ValueResult{ + false, + fmt.Sprintf("Expected a time.duration, got '%v' which is a %T", v, v), + } +}) + +// IsEqual tests that the given object is equal to the actual object. +func IsEqual(to interface{}) IsDef { + return Is("equals", func(v interface{}) ValueResult { + if assert.ObjectsAreEqual(v, to) { + return ValidVR + } + return ValueResult{ + false, + fmt.Sprintf("objects not equal: %v != %v", v, to), + } + }) +} + +// IsEqualToValue tests that the given value is equal to the actual value. +func IsEqualToValue(to interface{}) IsDef { + return Is("equals", func(v interface{}) ValueResult { + if assert.ObjectsAreEqualValues(v, to) { + return ValidVR + } + return ValueResult{ + false, + fmt.Sprintf("values not equal: %v != %v", v, to), + } + }) +} + +// IsNil tests that a value is nil. +var IsNil = Is("is nil", func(v interface{}) ValueResult { + if v == nil { + return ValidVR + } + return ValueResult{ + false, + fmt.Sprintf("Value %v is not nil", v), + } +}) + +func intGtChecker(than int) ValueValidator { + return func(v interface{}) ValueResult { + n, ok := v.(int) + if !ok { + msg := fmt.Sprintf("%v is a %T, but was expecting an int!", v, v) + return ValueResult{false, msg} + } + + if n > than { + return ValidVR + } + + return ValueResult{ + false, + fmt.Sprintf("%v is not greater than %v", n, than), + } + } +} + +// IsIntGt tests that a value is an int greater than. +func IsIntGt(than int) IsDef { + return Is("greater than", intGtChecker(than)) +} diff --git a/libbeat/common/mapval/results.go b/libbeat/common/mapval/results.go new file mode 100644 index 000000000000..56e53f69743f --- /dev/null +++ b/libbeat/common/mapval/results.go @@ -0,0 +1,93 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package mapval + +import "fmt" + +// Results the results of executing a schema. +// They are a flattened map (using dotted paths) of all the values []ValueResult representing the results +// of the IsDefs. +type Results map[string][]ValueResult + +func (r Results) recordResult(path string, result ValueResult) { + if r[path] == nil { + r[path] = []ValueResult{result} + } else { + r[path] = append(r[path], result) + } +} + +// EachResult executes the given callback once per Value result. +// The provided callback can return true to keep iterating, or false +// to stop. +func (r Results) EachResult(f func(string, ValueResult) bool) { + for path, pathResults := range r { + for _, result := range pathResults { + if !f(path, result) { + return + } + } + } +} + +// DetailedErrors returns a new Results object consisting only of error data. +func (r Results) DetailedErrors() Results { + errors := Results{} + r.EachResult(func(path string, vr ValueResult) bool { + if !vr.Valid { + errors.recordResult(path, vr) + } + + return true + }) + return errors +} + +// ValueResultError is used to represent an error validating an individual value. +type ValueResultError struct { + path string + valueResult ValueResult +} + +// Error returns the error that occurred during validation with its context included. +func (vre ValueResultError) Error() string { + return fmt.Sprintf("@path '%s': %s", vre.path, vre.valueResult.Message) +} + +// Errors returns a list of error objects, one per failed value validation. +func (r Results) Errors() []error { + var errors []error + + r.EachResult(func(path string, vr ValueResult) bool { + if !vr.Valid { + errors = append(errors, ValueResultError{path, vr}) + } + return true + }) + + return errors +} + +// Valid returns true if there are no errors. +func (r Results) Valid() bool { + r.EachResult(func(_ string, vr ValueResult) bool { + return vr.Valid + }) + // TODO: this is a pretty slow way to do this. + return len(r.Errors()) == 0 +} diff --git a/libbeat/common/mapval/value.go b/libbeat/common/mapval/value.go new file mode 100644 index 000000000000..b6944d9edac5 --- /dev/null +++ b/libbeat/common/mapval/value.go @@ -0,0 +1,69 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package mapval + +// ValueResult represents the result of checking a leaf value. +type ValueResult struct { + Valid bool + Message string // Reason this is invalid +} + +// A ValueValidator is used to validate a value in a Map. +type ValueValidator func(v interface{}) ValueResult + +// An IsDef defines the type of check to do. +// Generally only name and checker are set. optional and checkKeyMissing are +// needed for weird checks like key presence. +type IsDef struct { + name string + checker ValueValidator + optional bool + checkKeyMissing bool +} + +func (id IsDef) check(v interface{}, keyExists bool) ValueResult { + if id.checkKeyMissing { + if !keyExists { + return ValidVR + } + + return ValueResult{false, "key should not exist!"} + } + + if !id.optional && !keyExists { + return KeyMissingVR + } + + if id.checker != nil { + return id.checker(v) + } + + return ValidVR +} + +// ValidVR is a convenience value for Valid results. +var ValidVR = ValueResult{true, ""} + +// KeyMissingVR is emitted when a key was expected, but was not present. +var KeyMissingVR = ValueResult{ + false, + "expected to see a key here", +} + +// StrictFailureVR is emitted when Strict() is used, and an unexpected field is found. +var StrictFailureVR = ValueResult{false, "unexpected field encountered during strict validation"} diff --git a/libbeat/common/mapval/walk.go b/libbeat/common/mapval/walk.go new file mode 100644 index 000000000000..94bd10665f4d --- /dev/null +++ b/libbeat/common/mapval/walk.go @@ -0,0 +1,73 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package mapval + +import ( + "strings" + + "github.com/elastic/beats/libbeat/common" +) + +type walkObserverInfo struct { + key string + value interface{} + currentMap common.MapStr + rootMap common.MapStr + path []string + dottedPath string +} + +// walkObserver functions run once per object in the tree. +type walkObserver func(info walkObserverInfo) + +// walk is a shorthand way to walk a tree. +func walk(m common.MapStr, wo walkObserver) { + walkFull(m, m, []string{}, wo) +} + +// walkFull walks the given MapStr tree. +// TODO: Handle slices/arrays. We intentionally don't handle list types now because we don't need it (yet) +// and it isn't clear in the context of validation what the right thing is to do there beyond letting the user +// perform a custom validation +func walkFull(m common.MapStr, root common.MapStr, path []string, wo walkObserver) { + for k, v := range m { + splitK := strings.Split(k, ".") + newPath := make([]string, len(path)+len(splitK)) + copy(newPath, path) + copy(newPath[len(path):], splitK) + + dottedPath := strings.Join(newPath, ".") + + wo(walkObserverInfo{k, v, m, root, newPath, dottedPath}) + + // Walk nested maps + vIsMap := false + var mapV common.MapStr + if convertedMS, ok := v.(common.MapStr); ok { + mapV = convertedMS + vIsMap = true + } else if convertedM, ok := v.(Map); ok { + mapV = common.MapStr(convertedM) + vIsMap = true + } + + if vIsMap { + walkFull(mapV, root, newPath, wo) + } + } +} diff --git a/libbeat/testing/mapvaltest/mapvaltest.go b/libbeat/testing/mapvaltest/mapvaltest.go new file mode 100644 index 000000000000..20f8420e880c --- /dev/null +++ b/libbeat/testing/mapvaltest/mapvaltest.go @@ -0,0 +1,39 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package mapvaltest + +// skimatest is a separate package from skima since we don't want to import "testing" +// into skima, since there is a good chance we'll use skima for running user-defined +// tests in heartbeat at runtime. + +import ( + "testing" + + "github.com/stretchr/testify/assert" + + "github.com/elastic/beats/libbeat/common/mapval" +) + +// Test takes the output from a Validator invocation and runs test assertions on the result. +// If you are using this library for testing you will probably want to run Test(t, Schema(Map{...})(actual)) as a pattern. +func Test(t *testing.T, r mapval.Results) mapval.Results { + for _, err := range r.Errors() { + assert.NoError(t, err) + } + return r +} diff --git a/libbeat/testing/mapvaltest/mapvaltest_test.go b/libbeat/testing/mapvaltest/mapvaltest_test.go new file mode 100644 index 000000000000..41ccaed6df50 --- /dev/null +++ b/libbeat/testing/mapvaltest/mapvaltest_test.go @@ -0,0 +1,41 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package mapvaltest + +import ( + "testing" + + "github.com/stretchr/testify/assert" + + "github.com/elastic/beats/libbeat/common/mapval" +) + +func TestTest(t *testing.T) { + // Should pass + Test(t, mapval.Results{ + "foo": []mapval.ValueResult{mapval.ValidVR}, + }) + + fakeT := new(testing.T) + Test(fakeT, mapval.Results{ + "foo": []mapval.ValueResult{mapval.KeyMissingVR}, + }) + + assert.True(t, fakeT.Failed()) + +} diff --git a/vendor/github.com/stretchr/testify/require/doc.go b/vendor/github.com/stretchr/testify/require/doc.go new file mode 100644 index 000000000000..169de39221c7 --- /dev/null +++ b/vendor/github.com/stretchr/testify/require/doc.go @@ -0,0 +1,28 @@ +// Package require implements the same assertions as the `assert` package but +// stops test execution when a test fails. +// +// Example Usage +// +// The following is a complete example using require in a standard test function: +// import ( +// "testing" +// "github.com/stretchr/testify/require" +// ) +// +// func TestSomething(t *testing.T) { +// +// var a string = "Hello" +// var b string = "Hello" +// +// require.Equal(t, a, b, "The two words should be the same.") +// +// } +// +// Assertions +// +// The `require` package have same global functions as in the `assert` package, +// but instead of returning a boolean result they call `t.FailNow()`. +// +// Every assertion function also takes an optional string message as the final argument, +// allowing custom error messages to be appended to the message the assertion method outputs. +package require diff --git a/vendor/github.com/stretchr/testify/require/forward_requirements.go b/vendor/github.com/stretchr/testify/require/forward_requirements.go new file mode 100644 index 000000000000..ac71d40581b9 --- /dev/null +++ b/vendor/github.com/stretchr/testify/require/forward_requirements.go @@ -0,0 +1,16 @@ +package require + +// Assertions provides assertion methods around the +// TestingT interface. +type Assertions struct { + t TestingT +} + +// New makes a new Assertions object for the specified TestingT. +func New(t TestingT) *Assertions { + return &Assertions{ + t: t, + } +} + +//go:generate go run ../_codegen/main.go -output-package=require -template=require_forward.go.tmpl -include-format-funcs diff --git a/vendor/github.com/stretchr/testify/require/require.go b/vendor/github.com/stretchr/testify/require/require.go new file mode 100644 index 000000000000..535f293490ce --- /dev/null +++ b/vendor/github.com/stretchr/testify/require/require.go @@ -0,0 +1,1227 @@ +/* +* CODE GENERATED AUTOMATICALLY WITH github.com/stretchr/testify/_codegen +* THIS FILE MUST NOT BE EDITED BY HAND + */ + +package require + +import ( + assert "github.com/stretchr/testify/assert" + http "net/http" + url "net/url" + time "time" +) + +// Condition uses a Comparison to assert a complex condition. +func Condition(t TestingT, comp assert.Comparison, msgAndArgs ...interface{}) { + if assert.Condition(t, comp, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Conditionf uses a Comparison to assert a complex condition. +func Conditionf(t TestingT, comp assert.Comparison, msg string, args ...interface{}) { + if assert.Conditionf(t, comp, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Contains asserts that the specified string, list(array, slice...) or map contains the +// specified substring or element. +// +// assert.Contains(t, "Hello World", "World") +// assert.Contains(t, ["Hello", "World"], "World") +// assert.Contains(t, {"Hello": "World"}, "Hello") +func Contains(t TestingT, s interface{}, contains interface{}, msgAndArgs ...interface{}) { + if assert.Contains(t, s, contains, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Containsf asserts that the specified string, list(array, slice...) or map contains the +// specified substring or element. +// +// assert.Containsf(t, "Hello World", "World", "error message %s", "formatted") +// assert.Containsf(t, ["Hello", "World"], "World", "error message %s", "formatted") +// assert.Containsf(t, {"Hello": "World"}, "Hello", "error message %s", "formatted") +func Containsf(t TestingT, s interface{}, contains interface{}, msg string, args ...interface{}) { + if assert.Containsf(t, s, contains, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// DirExists checks whether a directory exists in the given path. It also fails if the path is a file rather a directory or there is an error checking whether it exists. +func DirExists(t TestingT, path string, msgAndArgs ...interface{}) { + if assert.DirExists(t, path, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// DirExistsf checks whether a directory exists in the given path. It also fails if the path is a file rather a directory or there is an error checking whether it exists. +func DirExistsf(t TestingT, path string, msg string, args ...interface{}) { + if assert.DirExistsf(t, path, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// ElementsMatch asserts that the specified listA(array, slice...) is equal to specified +// listB(array, slice...) ignoring the order of the elements. If there are duplicate elements, +// the number of appearances of each of them in both lists should match. +// +// assert.ElementsMatch(t, [1, 3, 2, 3], [1, 3, 3, 2]) +func ElementsMatch(t TestingT, listA interface{}, listB interface{}, msgAndArgs ...interface{}) { + if assert.ElementsMatch(t, listA, listB, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// ElementsMatchf asserts that the specified listA(array, slice...) is equal to specified +// listB(array, slice...) ignoring the order of the elements. If there are duplicate elements, +// the number of appearances of each of them in both lists should match. +// +// assert.ElementsMatchf(t, [1, 3, 2, 3], [1, 3, 3, 2], "error message %s", "formatted") +func ElementsMatchf(t TestingT, listA interface{}, listB interface{}, msg string, args ...interface{}) { + if assert.ElementsMatchf(t, listA, listB, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Empty asserts that the specified object is empty. I.e. nil, "", false, 0 or either +// a slice or a channel with len == 0. +// +// assert.Empty(t, obj) +func Empty(t TestingT, object interface{}, msgAndArgs ...interface{}) { + if assert.Empty(t, object, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Emptyf asserts that the specified object is empty. I.e. nil, "", false, 0 or either +// a slice or a channel with len == 0. +// +// assert.Emptyf(t, obj, "error message %s", "formatted") +func Emptyf(t TestingT, object interface{}, msg string, args ...interface{}) { + if assert.Emptyf(t, object, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Equal asserts that two objects are equal. +// +// assert.Equal(t, 123, 123) +// +// Pointer variable equality is determined based on the equality of the +// referenced values (as opposed to the memory addresses). Function equality +// cannot be determined and will always fail. +func Equal(t TestingT, expected interface{}, actual interface{}, msgAndArgs ...interface{}) { + if assert.Equal(t, expected, actual, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// EqualError asserts that a function returned an error (i.e. not `nil`) +// and that it is equal to the provided error. +// +// actualObj, err := SomeFunction() +// assert.EqualError(t, err, expectedErrorString) +func EqualError(t TestingT, theError error, errString string, msgAndArgs ...interface{}) { + if assert.EqualError(t, theError, errString, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// EqualErrorf asserts that a function returned an error (i.e. not `nil`) +// and that it is equal to the provided error. +// +// actualObj, err := SomeFunction() +// assert.EqualErrorf(t, err, expectedErrorString, "error message %s", "formatted") +func EqualErrorf(t TestingT, theError error, errString string, msg string, args ...interface{}) { + if assert.EqualErrorf(t, theError, errString, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// EqualValues asserts that two objects are equal or convertable to the same types +// and equal. +// +// assert.EqualValues(t, uint32(123), int32(123)) +func EqualValues(t TestingT, expected interface{}, actual interface{}, msgAndArgs ...interface{}) { + if assert.EqualValues(t, expected, actual, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// EqualValuesf asserts that two objects are equal or convertable to the same types +// and equal. +// +// assert.EqualValuesf(t, uint32(123, "error message %s", "formatted"), int32(123)) +func EqualValuesf(t TestingT, expected interface{}, actual interface{}, msg string, args ...interface{}) { + if assert.EqualValuesf(t, expected, actual, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Equalf asserts that two objects are equal. +// +// assert.Equalf(t, 123, 123, "error message %s", "formatted") +// +// Pointer variable equality is determined based on the equality of the +// referenced values (as opposed to the memory addresses). Function equality +// cannot be determined and will always fail. +func Equalf(t TestingT, expected interface{}, actual interface{}, msg string, args ...interface{}) { + if assert.Equalf(t, expected, actual, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Error asserts that a function returned an error (i.e. not `nil`). +// +// actualObj, err := SomeFunction() +// if assert.Error(t, err) { +// assert.Equal(t, expectedError, err) +// } +func Error(t TestingT, err error, msgAndArgs ...interface{}) { + if assert.Error(t, err, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Errorf asserts that a function returned an error (i.e. not `nil`). +// +// actualObj, err := SomeFunction() +// if assert.Errorf(t, err, "error message %s", "formatted") { +// assert.Equal(t, expectedErrorf, err) +// } +func Errorf(t TestingT, err error, msg string, args ...interface{}) { + if assert.Errorf(t, err, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Exactly asserts that two objects are equal in value and type. +// +// assert.Exactly(t, int32(123), int64(123)) +func Exactly(t TestingT, expected interface{}, actual interface{}, msgAndArgs ...interface{}) { + if assert.Exactly(t, expected, actual, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Exactlyf asserts that two objects are equal in value and type. +// +// assert.Exactlyf(t, int32(123, "error message %s", "formatted"), int64(123)) +func Exactlyf(t TestingT, expected interface{}, actual interface{}, msg string, args ...interface{}) { + if assert.Exactlyf(t, expected, actual, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Fail reports a failure through +func Fail(t TestingT, failureMessage string, msgAndArgs ...interface{}) { + if assert.Fail(t, failureMessage, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// FailNow fails test +func FailNow(t TestingT, failureMessage string, msgAndArgs ...interface{}) { + if assert.FailNow(t, failureMessage, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// FailNowf fails test +func FailNowf(t TestingT, failureMessage string, msg string, args ...interface{}) { + if assert.FailNowf(t, failureMessage, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Failf reports a failure through +func Failf(t TestingT, failureMessage string, msg string, args ...interface{}) { + if assert.Failf(t, failureMessage, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// False asserts that the specified value is false. +// +// assert.False(t, myBool) +func False(t TestingT, value bool, msgAndArgs ...interface{}) { + if assert.False(t, value, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Falsef asserts that the specified value is false. +// +// assert.Falsef(t, myBool, "error message %s", "formatted") +func Falsef(t TestingT, value bool, msg string, args ...interface{}) { + if assert.Falsef(t, value, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// FileExists checks whether a file exists in the given path. It also fails if the path points to a directory or there is an error when trying to check the file. +func FileExists(t TestingT, path string, msgAndArgs ...interface{}) { + if assert.FileExists(t, path, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// FileExistsf checks whether a file exists in the given path. It also fails if the path points to a directory or there is an error when trying to check the file. +func FileExistsf(t TestingT, path string, msg string, args ...interface{}) { + if assert.FileExistsf(t, path, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// HTTPBodyContains asserts that a specified handler returns a +// body that contains a string. +// +// assert.HTTPBodyContains(t, myHandler, "GET", "www.google.com", nil, "I'm Feeling Lucky") +// +// Returns whether the assertion was successful (true) or not (false). +func HTTPBodyContains(t TestingT, handler http.HandlerFunc, method string, url string, values url.Values, str interface{}, msgAndArgs ...interface{}) { + if assert.HTTPBodyContains(t, handler, method, url, values, str, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// HTTPBodyContainsf asserts that a specified handler returns a +// body that contains a string. +// +// assert.HTTPBodyContainsf(t, myHandler, "GET", "www.google.com", nil, "I'm Feeling Lucky", "error message %s", "formatted") +// +// Returns whether the assertion was successful (true) or not (false). +func HTTPBodyContainsf(t TestingT, handler http.HandlerFunc, method string, url string, values url.Values, str interface{}, msg string, args ...interface{}) { + if assert.HTTPBodyContainsf(t, handler, method, url, values, str, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// HTTPBodyNotContains asserts that a specified handler returns a +// body that does not contain a string. +// +// assert.HTTPBodyNotContains(t, myHandler, "GET", "www.google.com", nil, "I'm Feeling Lucky") +// +// Returns whether the assertion was successful (true) or not (false). +func HTTPBodyNotContains(t TestingT, handler http.HandlerFunc, method string, url string, values url.Values, str interface{}, msgAndArgs ...interface{}) { + if assert.HTTPBodyNotContains(t, handler, method, url, values, str, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// HTTPBodyNotContainsf asserts that a specified handler returns a +// body that does not contain a string. +// +// assert.HTTPBodyNotContainsf(t, myHandler, "GET", "www.google.com", nil, "I'm Feeling Lucky", "error message %s", "formatted") +// +// Returns whether the assertion was successful (true) or not (false). +func HTTPBodyNotContainsf(t TestingT, handler http.HandlerFunc, method string, url string, values url.Values, str interface{}, msg string, args ...interface{}) { + if assert.HTTPBodyNotContainsf(t, handler, method, url, values, str, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// HTTPError asserts that a specified handler returns an error status code. +// +// assert.HTTPError(t, myHandler, "POST", "/a/b/c", url.Values{"a": []string{"b", "c"}} +// +// Returns whether the assertion was successful (true) or not (false). +func HTTPError(t TestingT, handler http.HandlerFunc, method string, url string, values url.Values, msgAndArgs ...interface{}) { + if assert.HTTPError(t, handler, method, url, values, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// HTTPErrorf asserts that a specified handler returns an error status code. +// +// assert.HTTPErrorf(t, myHandler, "POST", "/a/b/c", url.Values{"a": []string{"b", "c"}} +// +// Returns whether the assertion was successful (true, "error message %s", "formatted") or not (false). +func HTTPErrorf(t TestingT, handler http.HandlerFunc, method string, url string, values url.Values, msg string, args ...interface{}) { + if assert.HTTPErrorf(t, handler, method, url, values, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// HTTPRedirect asserts that a specified handler returns a redirect status code. +// +// assert.HTTPRedirect(t, myHandler, "GET", "/a/b/c", url.Values{"a": []string{"b", "c"}} +// +// Returns whether the assertion was successful (true) or not (false). +func HTTPRedirect(t TestingT, handler http.HandlerFunc, method string, url string, values url.Values, msgAndArgs ...interface{}) { + if assert.HTTPRedirect(t, handler, method, url, values, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// HTTPRedirectf asserts that a specified handler returns a redirect status code. +// +// assert.HTTPRedirectf(t, myHandler, "GET", "/a/b/c", url.Values{"a": []string{"b", "c"}} +// +// Returns whether the assertion was successful (true, "error message %s", "formatted") or not (false). +func HTTPRedirectf(t TestingT, handler http.HandlerFunc, method string, url string, values url.Values, msg string, args ...interface{}) { + if assert.HTTPRedirectf(t, handler, method, url, values, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// HTTPSuccess asserts that a specified handler returns a success status code. +// +// assert.HTTPSuccess(t, myHandler, "POST", "http://www.google.com", nil) +// +// Returns whether the assertion was successful (true) or not (false). +func HTTPSuccess(t TestingT, handler http.HandlerFunc, method string, url string, values url.Values, msgAndArgs ...interface{}) { + if assert.HTTPSuccess(t, handler, method, url, values, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// HTTPSuccessf asserts that a specified handler returns a success status code. +// +// assert.HTTPSuccessf(t, myHandler, "POST", "http://www.google.com", nil, "error message %s", "formatted") +// +// Returns whether the assertion was successful (true) or not (false). +func HTTPSuccessf(t TestingT, handler http.HandlerFunc, method string, url string, values url.Values, msg string, args ...interface{}) { + if assert.HTTPSuccessf(t, handler, method, url, values, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Implements asserts that an object is implemented by the specified interface. +// +// assert.Implements(t, (*MyInterface)(nil), new(MyObject)) +func Implements(t TestingT, interfaceObject interface{}, object interface{}, msgAndArgs ...interface{}) { + if assert.Implements(t, interfaceObject, object, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Implementsf asserts that an object is implemented by the specified interface. +// +// assert.Implementsf(t, (*MyInterface, "error message %s", "formatted")(nil), new(MyObject)) +func Implementsf(t TestingT, interfaceObject interface{}, object interface{}, msg string, args ...interface{}) { + if assert.Implementsf(t, interfaceObject, object, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// InDelta asserts that the two numerals are within delta of each other. +// +// assert.InDelta(t, math.Pi, (22 / 7.0), 0.01) +func InDelta(t TestingT, expected interface{}, actual interface{}, delta float64, msgAndArgs ...interface{}) { + if assert.InDelta(t, expected, actual, delta, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// InDeltaMapValues is the same as InDelta, but it compares all values between two maps. Both maps must have exactly the same keys. +func InDeltaMapValues(t TestingT, expected interface{}, actual interface{}, delta float64, msgAndArgs ...interface{}) { + if assert.InDeltaMapValues(t, expected, actual, delta, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// InDeltaMapValuesf is the same as InDelta, but it compares all values between two maps. Both maps must have exactly the same keys. +func InDeltaMapValuesf(t TestingT, expected interface{}, actual interface{}, delta float64, msg string, args ...interface{}) { + if assert.InDeltaMapValuesf(t, expected, actual, delta, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// InDeltaSlice is the same as InDelta, except it compares two slices. +func InDeltaSlice(t TestingT, expected interface{}, actual interface{}, delta float64, msgAndArgs ...interface{}) { + if assert.InDeltaSlice(t, expected, actual, delta, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// InDeltaSlicef is the same as InDelta, except it compares two slices. +func InDeltaSlicef(t TestingT, expected interface{}, actual interface{}, delta float64, msg string, args ...interface{}) { + if assert.InDeltaSlicef(t, expected, actual, delta, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// InDeltaf asserts that the two numerals are within delta of each other. +// +// assert.InDeltaf(t, math.Pi, (22 / 7.0, "error message %s", "formatted"), 0.01) +func InDeltaf(t TestingT, expected interface{}, actual interface{}, delta float64, msg string, args ...interface{}) { + if assert.InDeltaf(t, expected, actual, delta, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// InEpsilon asserts that expected and actual have a relative error less than epsilon +func InEpsilon(t TestingT, expected interface{}, actual interface{}, epsilon float64, msgAndArgs ...interface{}) { + if assert.InEpsilon(t, expected, actual, epsilon, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// InEpsilonSlice is the same as InEpsilon, except it compares each value from two slices. +func InEpsilonSlice(t TestingT, expected interface{}, actual interface{}, epsilon float64, msgAndArgs ...interface{}) { + if assert.InEpsilonSlice(t, expected, actual, epsilon, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// InEpsilonSlicef is the same as InEpsilon, except it compares each value from two slices. +func InEpsilonSlicef(t TestingT, expected interface{}, actual interface{}, epsilon float64, msg string, args ...interface{}) { + if assert.InEpsilonSlicef(t, expected, actual, epsilon, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// InEpsilonf asserts that expected and actual have a relative error less than epsilon +func InEpsilonf(t TestingT, expected interface{}, actual interface{}, epsilon float64, msg string, args ...interface{}) { + if assert.InEpsilonf(t, expected, actual, epsilon, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// IsType asserts that the specified objects are of the same type. +func IsType(t TestingT, expectedType interface{}, object interface{}, msgAndArgs ...interface{}) { + if assert.IsType(t, expectedType, object, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// IsTypef asserts that the specified objects are of the same type. +func IsTypef(t TestingT, expectedType interface{}, object interface{}, msg string, args ...interface{}) { + if assert.IsTypef(t, expectedType, object, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// JSONEq asserts that two JSON strings are equivalent. +// +// assert.JSONEq(t, `{"hello": "world", "foo": "bar"}`, `{"foo": "bar", "hello": "world"}`) +func JSONEq(t TestingT, expected string, actual string, msgAndArgs ...interface{}) { + if assert.JSONEq(t, expected, actual, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// JSONEqf asserts that two JSON strings are equivalent. +// +// assert.JSONEqf(t, `{"hello": "world", "foo": "bar"}`, `{"foo": "bar", "hello": "world"}`, "error message %s", "formatted") +func JSONEqf(t TestingT, expected string, actual string, msg string, args ...interface{}) { + if assert.JSONEqf(t, expected, actual, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Len asserts that the specified object has specific length. +// Len also fails if the object has a type that len() not accept. +// +// assert.Len(t, mySlice, 3) +func Len(t TestingT, object interface{}, length int, msgAndArgs ...interface{}) { + if assert.Len(t, object, length, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Lenf asserts that the specified object has specific length. +// Lenf also fails if the object has a type that len() not accept. +// +// assert.Lenf(t, mySlice, 3, "error message %s", "formatted") +func Lenf(t TestingT, object interface{}, length int, msg string, args ...interface{}) { + if assert.Lenf(t, object, length, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Nil asserts that the specified object is nil. +// +// assert.Nil(t, err) +func Nil(t TestingT, object interface{}, msgAndArgs ...interface{}) { + if assert.Nil(t, object, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Nilf asserts that the specified object is nil. +// +// assert.Nilf(t, err, "error message %s", "formatted") +func Nilf(t TestingT, object interface{}, msg string, args ...interface{}) { + if assert.Nilf(t, object, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NoError asserts that a function returned no error (i.e. `nil`). +// +// actualObj, err := SomeFunction() +// if assert.NoError(t, err) { +// assert.Equal(t, expectedObj, actualObj) +// } +func NoError(t TestingT, err error, msgAndArgs ...interface{}) { + if assert.NoError(t, err, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NoErrorf asserts that a function returned no error (i.e. `nil`). +// +// actualObj, err := SomeFunction() +// if assert.NoErrorf(t, err, "error message %s", "formatted") { +// assert.Equal(t, expectedObj, actualObj) +// } +func NoErrorf(t TestingT, err error, msg string, args ...interface{}) { + if assert.NoErrorf(t, err, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotContains asserts that the specified string, list(array, slice...) or map does NOT contain the +// specified substring or element. +// +// assert.NotContains(t, "Hello World", "Earth") +// assert.NotContains(t, ["Hello", "World"], "Earth") +// assert.NotContains(t, {"Hello": "World"}, "Earth") +func NotContains(t TestingT, s interface{}, contains interface{}, msgAndArgs ...interface{}) { + if assert.NotContains(t, s, contains, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotContainsf asserts that the specified string, list(array, slice...) or map does NOT contain the +// specified substring or element. +// +// assert.NotContainsf(t, "Hello World", "Earth", "error message %s", "formatted") +// assert.NotContainsf(t, ["Hello", "World"], "Earth", "error message %s", "formatted") +// assert.NotContainsf(t, {"Hello": "World"}, "Earth", "error message %s", "formatted") +func NotContainsf(t TestingT, s interface{}, contains interface{}, msg string, args ...interface{}) { + if assert.NotContainsf(t, s, contains, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotEmpty asserts that the specified object is NOT empty. I.e. not nil, "", false, 0 or either +// a slice or a channel with len == 0. +// +// if assert.NotEmpty(t, obj) { +// assert.Equal(t, "two", obj[1]) +// } +func NotEmpty(t TestingT, object interface{}, msgAndArgs ...interface{}) { + if assert.NotEmpty(t, object, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotEmptyf asserts that the specified object is NOT empty. I.e. not nil, "", false, 0 or either +// a slice or a channel with len == 0. +// +// if assert.NotEmptyf(t, obj, "error message %s", "formatted") { +// assert.Equal(t, "two", obj[1]) +// } +func NotEmptyf(t TestingT, object interface{}, msg string, args ...interface{}) { + if assert.NotEmptyf(t, object, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotEqual asserts that the specified values are NOT equal. +// +// assert.NotEqual(t, obj1, obj2) +// +// Pointer variable equality is determined based on the equality of the +// referenced values (as opposed to the memory addresses). +func NotEqual(t TestingT, expected interface{}, actual interface{}, msgAndArgs ...interface{}) { + if assert.NotEqual(t, expected, actual, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotEqualf asserts that the specified values are NOT equal. +// +// assert.NotEqualf(t, obj1, obj2, "error message %s", "formatted") +// +// Pointer variable equality is determined based on the equality of the +// referenced values (as opposed to the memory addresses). +func NotEqualf(t TestingT, expected interface{}, actual interface{}, msg string, args ...interface{}) { + if assert.NotEqualf(t, expected, actual, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotNil asserts that the specified object is not nil. +// +// assert.NotNil(t, err) +func NotNil(t TestingT, object interface{}, msgAndArgs ...interface{}) { + if assert.NotNil(t, object, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotNilf asserts that the specified object is not nil. +// +// assert.NotNilf(t, err, "error message %s", "formatted") +func NotNilf(t TestingT, object interface{}, msg string, args ...interface{}) { + if assert.NotNilf(t, object, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotPanics asserts that the code inside the specified PanicTestFunc does NOT panic. +// +// assert.NotPanics(t, func(){ RemainCalm() }) +func NotPanics(t TestingT, f assert.PanicTestFunc, msgAndArgs ...interface{}) { + if assert.NotPanics(t, f, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotPanicsf asserts that the code inside the specified PanicTestFunc does NOT panic. +// +// assert.NotPanicsf(t, func(){ RemainCalm() }, "error message %s", "formatted") +func NotPanicsf(t TestingT, f assert.PanicTestFunc, msg string, args ...interface{}) { + if assert.NotPanicsf(t, f, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotRegexp asserts that a specified regexp does not match a string. +// +// assert.NotRegexp(t, regexp.MustCompile("starts"), "it's starting") +// assert.NotRegexp(t, "^start", "it's not starting") +func NotRegexp(t TestingT, rx interface{}, str interface{}, msgAndArgs ...interface{}) { + if assert.NotRegexp(t, rx, str, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotRegexpf asserts that a specified regexp does not match a string. +// +// assert.NotRegexpf(t, regexp.MustCompile("starts", "error message %s", "formatted"), "it's starting") +// assert.NotRegexpf(t, "^start", "it's not starting", "error message %s", "formatted") +func NotRegexpf(t TestingT, rx interface{}, str interface{}, msg string, args ...interface{}) { + if assert.NotRegexpf(t, rx, str, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotSubset asserts that the specified list(array, slice...) contains not all +// elements given in the specified subset(array, slice...). +// +// assert.NotSubset(t, [1, 3, 4], [1, 2], "But [1, 3, 4] does not contain [1, 2]") +func NotSubset(t TestingT, list interface{}, subset interface{}, msgAndArgs ...interface{}) { + if assert.NotSubset(t, list, subset, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotSubsetf asserts that the specified list(array, slice...) contains not all +// elements given in the specified subset(array, slice...). +// +// assert.NotSubsetf(t, [1, 3, 4], [1, 2], "But [1, 3, 4] does not contain [1, 2]", "error message %s", "formatted") +func NotSubsetf(t TestingT, list interface{}, subset interface{}, msg string, args ...interface{}) { + if assert.NotSubsetf(t, list, subset, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotZero asserts that i is not the zero value for its type. +func NotZero(t TestingT, i interface{}, msgAndArgs ...interface{}) { + if assert.NotZero(t, i, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// NotZerof asserts that i is not the zero value for its type. +func NotZerof(t TestingT, i interface{}, msg string, args ...interface{}) { + if assert.NotZerof(t, i, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Panics asserts that the code inside the specified PanicTestFunc panics. +// +// assert.Panics(t, func(){ GoCrazy() }) +func Panics(t TestingT, f assert.PanicTestFunc, msgAndArgs ...interface{}) { + if assert.Panics(t, f, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// PanicsWithValue asserts that the code inside the specified PanicTestFunc panics, and that +// the recovered panic value equals the expected panic value. +// +// assert.PanicsWithValue(t, "crazy error", func(){ GoCrazy() }) +func PanicsWithValue(t TestingT, expected interface{}, f assert.PanicTestFunc, msgAndArgs ...interface{}) { + if assert.PanicsWithValue(t, expected, f, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// PanicsWithValuef asserts that the code inside the specified PanicTestFunc panics, and that +// the recovered panic value equals the expected panic value. +// +// assert.PanicsWithValuef(t, "crazy error", func(){ GoCrazy() }, "error message %s", "formatted") +func PanicsWithValuef(t TestingT, expected interface{}, f assert.PanicTestFunc, msg string, args ...interface{}) { + if assert.PanicsWithValuef(t, expected, f, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Panicsf asserts that the code inside the specified PanicTestFunc panics. +// +// assert.Panicsf(t, func(){ GoCrazy() }, "error message %s", "formatted") +func Panicsf(t TestingT, f assert.PanicTestFunc, msg string, args ...interface{}) { + if assert.Panicsf(t, f, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Regexp asserts that a specified regexp matches a string. +// +// assert.Regexp(t, regexp.MustCompile("start"), "it's starting") +// assert.Regexp(t, "start...$", "it's not starting") +func Regexp(t TestingT, rx interface{}, str interface{}, msgAndArgs ...interface{}) { + if assert.Regexp(t, rx, str, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Regexpf asserts that a specified regexp matches a string. +// +// assert.Regexpf(t, regexp.MustCompile("start", "error message %s", "formatted"), "it's starting") +// assert.Regexpf(t, "start...$", "it's not starting", "error message %s", "formatted") +func Regexpf(t TestingT, rx interface{}, str interface{}, msg string, args ...interface{}) { + if assert.Regexpf(t, rx, str, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Subset asserts that the specified list(array, slice...) contains all +// elements given in the specified subset(array, slice...). +// +// assert.Subset(t, [1, 2, 3], [1, 2], "But [1, 2, 3] does contain [1, 2]") +func Subset(t TestingT, list interface{}, subset interface{}, msgAndArgs ...interface{}) { + if assert.Subset(t, list, subset, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Subsetf asserts that the specified list(array, slice...) contains all +// elements given in the specified subset(array, slice...). +// +// assert.Subsetf(t, [1, 2, 3], [1, 2], "But [1, 2, 3] does contain [1, 2]", "error message %s", "formatted") +func Subsetf(t TestingT, list interface{}, subset interface{}, msg string, args ...interface{}) { + if assert.Subsetf(t, list, subset, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// True asserts that the specified value is true. +// +// assert.True(t, myBool) +func True(t TestingT, value bool, msgAndArgs ...interface{}) { + if assert.True(t, value, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Truef asserts that the specified value is true. +// +// assert.Truef(t, myBool, "error message %s", "formatted") +func Truef(t TestingT, value bool, msg string, args ...interface{}) { + if assert.Truef(t, value, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// WithinDuration asserts that the two times are within duration delta of each other. +// +// assert.WithinDuration(t, time.Now(), time.Now(), 10*time.Second) +func WithinDuration(t TestingT, expected time.Time, actual time.Time, delta time.Duration, msgAndArgs ...interface{}) { + if assert.WithinDuration(t, expected, actual, delta, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// WithinDurationf asserts that the two times are within duration delta of each other. +// +// assert.WithinDurationf(t, time.Now(), time.Now(), 10*time.Second, "error message %s", "formatted") +func WithinDurationf(t TestingT, expected time.Time, actual time.Time, delta time.Duration, msg string, args ...interface{}) { + if assert.WithinDurationf(t, expected, actual, delta, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Zero asserts that i is the zero value for its type. +func Zero(t TestingT, i interface{}, msgAndArgs ...interface{}) { + if assert.Zero(t, i, msgAndArgs...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} + +// Zerof asserts that i is the zero value for its type. +func Zerof(t TestingT, i interface{}, msg string, args ...interface{}) { + if assert.Zerof(t, i, msg, args...) { + return + } + if h, ok := t.(tHelper); ok { + h.Helper() + } + t.FailNow() +} diff --git a/vendor/github.com/stretchr/testify/require/require.go.tmpl b/vendor/github.com/stretchr/testify/require/require.go.tmpl new file mode 100644 index 000000000000..6ffc751b5e50 --- /dev/null +++ b/vendor/github.com/stretchr/testify/require/require.go.tmpl @@ -0,0 +1,6 @@ +{{.Comment}} +func {{.DocInfo.Name}}(t TestingT, {{.Params}}) { + if assert.{{.DocInfo.Name}}(t, {{.ForwardedParams}}) { return } + if h, ok := t.(tHelper); ok { h.Helper() } + t.FailNow() +} diff --git a/vendor/github.com/stretchr/testify/require/require_forward.go b/vendor/github.com/stretchr/testify/require/require_forward.go new file mode 100644 index 000000000000..9fe41dbdc0cb --- /dev/null +++ b/vendor/github.com/stretchr/testify/require/require_forward.go @@ -0,0 +1,957 @@ +/* +* CODE GENERATED AUTOMATICALLY WITH github.com/stretchr/testify/_codegen +* THIS FILE MUST NOT BE EDITED BY HAND + */ + +package require + +import ( + assert "github.com/stretchr/testify/assert" + http "net/http" + url "net/url" + time "time" +) + +// Condition uses a Comparison to assert a complex condition. +func (a *Assertions) Condition(comp assert.Comparison, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Condition(a.t, comp, msgAndArgs...) +} + +// Conditionf uses a Comparison to assert a complex condition. +func (a *Assertions) Conditionf(comp assert.Comparison, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Conditionf(a.t, comp, msg, args...) +} + +// Contains asserts that the specified string, list(array, slice...) or map contains the +// specified substring or element. +// +// a.Contains("Hello World", "World") +// a.Contains(["Hello", "World"], "World") +// a.Contains({"Hello": "World"}, "Hello") +func (a *Assertions) Contains(s interface{}, contains interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Contains(a.t, s, contains, msgAndArgs...) +} + +// Containsf asserts that the specified string, list(array, slice...) or map contains the +// specified substring or element. +// +// a.Containsf("Hello World", "World", "error message %s", "formatted") +// a.Containsf(["Hello", "World"], "World", "error message %s", "formatted") +// a.Containsf({"Hello": "World"}, "Hello", "error message %s", "formatted") +func (a *Assertions) Containsf(s interface{}, contains interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Containsf(a.t, s, contains, msg, args...) +} + +// DirExists checks whether a directory exists in the given path. It also fails if the path is a file rather a directory or there is an error checking whether it exists. +func (a *Assertions) DirExists(path string, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + DirExists(a.t, path, msgAndArgs...) +} + +// DirExistsf checks whether a directory exists in the given path. It also fails if the path is a file rather a directory or there is an error checking whether it exists. +func (a *Assertions) DirExistsf(path string, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + DirExistsf(a.t, path, msg, args...) +} + +// ElementsMatch asserts that the specified listA(array, slice...) is equal to specified +// listB(array, slice...) ignoring the order of the elements. If there are duplicate elements, +// the number of appearances of each of them in both lists should match. +// +// a.ElementsMatch([1, 3, 2, 3], [1, 3, 3, 2]) +func (a *Assertions) ElementsMatch(listA interface{}, listB interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + ElementsMatch(a.t, listA, listB, msgAndArgs...) +} + +// ElementsMatchf asserts that the specified listA(array, slice...) is equal to specified +// listB(array, slice...) ignoring the order of the elements. If there are duplicate elements, +// the number of appearances of each of them in both lists should match. +// +// a.ElementsMatchf([1, 3, 2, 3], [1, 3, 3, 2], "error message %s", "formatted") +func (a *Assertions) ElementsMatchf(listA interface{}, listB interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + ElementsMatchf(a.t, listA, listB, msg, args...) +} + +// Empty asserts that the specified object is empty. I.e. nil, "", false, 0 or either +// a slice or a channel with len == 0. +// +// a.Empty(obj) +func (a *Assertions) Empty(object interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Empty(a.t, object, msgAndArgs...) +} + +// Emptyf asserts that the specified object is empty. I.e. nil, "", false, 0 or either +// a slice or a channel with len == 0. +// +// a.Emptyf(obj, "error message %s", "formatted") +func (a *Assertions) Emptyf(object interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Emptyf(a.t, object, msg, args...) +} + +// Equal asserts that two objects are equal. +// +// a.Equal(123, 123) +// +// Pointer variable equality is determined based on the equality of the +// referenced values (as opposed to the memory addresses). Function equality +// cannot be determined and will always fail. +func (a *Assertions) Equal(expected interface{}, actual interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Equal(a.t, expected, actual, msgAndArgs...) +} + +// EqualError asserts that a function returned an error (i.e. not `nil`) +// and that it is equal to the provided error. +// +// actualObj, err := SomeFunction() +// a.EqualError(err, expectedErrorString) +func (a *Assertions) EqualError(theError error, errString string, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + EqualError(a.t, theError, errString, msgAndArgs...) +} + +// EqualErrorf asserts that a function returned an error (i.e. not `nil`) +// and that it is equal to the provided error. +// +// actualObj, err := SomeFunction() +// a.EqualErrorf(err, expectedErrorString, "error message %s", "formatted") +func (a *Assertions) EqualErrorf(theError error, errString string, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + EqualErrorf(a.t, theError, errString, msg, args...) +} + +// EqualValues asserts that two objects are equal or convertable to the same types +// and equal. +// +// a.EqualValues(uint32(123), int32(123)) +func (a *Assertions) EqualValues(expected interface{}, actual interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + EqualValues(a.t, expected, actual, msgAndArgs...) +} + +// EqualValuesf asserts that two objects are equal or convertable to the same types +// and equal. +// +// a.EqualValuesf(uint32(123, "error message %s", "formatted"), int32(123)) +func (a *Assertions) EqualValuesf(expected interface{}, actual interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + EqualValuesf(a.t, expected, actual, msg, args...) +} + +// Equalf asserts that two objects are equal. +// +// a.Equalf(123, 123, "error message %s", "formatted") +// +// Pointer variable equality is determined based on the equality of the +// referenced values (as opposed to the memory addresses). Function equality +// cannot be determined and will always fail. +func (a *Assertions) Equalf(expected interface{}, actual interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Equalf(a.t, expected, actual, msg, args...) +} + +// Error asserts that a function returned an error (i.e. not `nil`). +// +// actualObj, err := SomeFunction() +// if a.Error(err) { +// assert.Equal(t, expectedError, err) +// } +func (a *Assertions) Error(err error, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Error(a.t, err, msgAndArgs...) +} + +// Errorf asserts that a function returned an error (i.e. not `nil`). +// +// actualObj, err := SomeFunction() +// if a.Errorf(err, "error message %s", "formatted") { +// assert.Equal(t, expectedErrorf, err) +// } +func (a *Assertions) Errorf(err error, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Errorf(a.t, err, msg, args...) +} + +// Exactly asserts that two objects are equal in value and type. +// +// a.Exactly(int32(123), int64(123)) +func (a *Assertions) Exactly(expected interface{}, actual interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Exactly(a.t, expected, actual, msgAndArgs...) +} + +// Exactlyf asserts that two objects are equal in value and type. +// +// a.Exactlyf(int32(123, "error message %s", "formatted"), int64(123)) +func (a *Assertions) Exactlyf(expected interface{}, actual interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Exactlyf(a.t, expected, actual, msg, args...) +} + +// Fail reports a failure through +func (a *Assertions) Fail(failureMessage string, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Fail(a.t, failureMessage, msgAndArgs...) +} + +// FailNow fails test +func (a *Assertions) FailNow(failureMessage string, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + FailNow(a.t, failureMessage, msgAndArgs...) +} + +// FailNowf fails test +func (a *Assertions) FailNowf(failureMessage string, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + FailNowf(a.t, failureMessage, msg, args...) +} + +// Failf reports a failure through +func (a *Assertions) Failf(failureMessage string, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Failf(a.t, failureMessage, msg, args...) +} + +// False asserts that the specified value is false. +// +// a.False(myBool) +func (a *Assertions) False(value bool, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + False(a.t, value, msgAndArgs...) +} + +// Falsef asserts that the specified value is false. +// +// a.Falsef(myBool, "error message %s", "formatted") +func (a *Assertions) Falsef(value bool, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Falsef(a.t, value, msg, args...) +} + +// FileExists checks whether a file exists in the given path. It also fails if the path points to a directory or there is an error when trying to check the file. +func (a *Assertions) FileExists(path string, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + FileExists(a.t, path, msgAndArgs...) +} + +// FileExistsf checks whether a file exists in the given path. It also fails if the path points to a directory or there is an error when trying to check the file. +func (a *Assertions) FileExistsf(path string, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + FileExistsf(a.t, path, msg, args...) +} + +// HTTPBodyContains asserts that a specified handler returns a +// body that contains a string. +// +// a.HTTPBodyContains(myHandler, "GET", "www.google.com", nil, "I'm Feeling Lucky") +// +// Returns whether the assertion was successful (true) or not (false). +func (a *Assertions) HTTPBodyContains(handler http.HandlerFunc, method string, url string, values url.Values, str interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + HTTPBodyContains(a.t, handler, method, url, values, str, msgAndArgs...) +} + +// HTTPBodyContainsf asserts that a specified handler returns a +// body that contains a string. +// +// a.HTTPBodyContainsf(myHandler, "GET", "www.google.com", nil, "I'm Feeling Lucky", "error message %s", "formatted") +// +// Returns whether the assertion was successful (true) or not (false). +func (a *Assertions) HTTPBodyContainsf(handler http.HandlerFunc, method string, url string, values url.Values, str interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + HTTPBodyContainsf(a.t, handler, method, url, values, str, msg, args...) +} + +// HTTPBodyNotContains asserts that a specified handler returns a +// body that does not contain a string. +// +// a.HTTPBodyNotContains(myHandler, "GET", "www.google.com", nil, "I'm Feeling Lucky") +// +// Returns whether the assertion was successful (true) or not (false). +func (a *Assertions) HTTPBodyNotContains(handler http.HandlerFunc, method string, url string, values url.Values, str interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + HTTPBodyNotContains(a.t, handler, method, url, values, str, msgAndArgs...) +} + +// HTTPBodyNotContainsf asserts that a specified handler returns a +// body that does not contain a string. +// +// a.HTTPBodyNotContainsf(myHandler, "GET", "www.google.com", nil, "I'm Feeling Lucky", "error message %s", "formatted") +// +// Returns whether the assertion was successful (true) or not (false). +func (a *Assertions) HTTPBodyNotContainsf(handler http.HandlerFunc, method string, url string, values url.Values, str interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + HTTPBodyNotContainsf(a.t, handler, method, url, values, str, msg, args...) +} + +// HTTPError asserts that a specified handler returns an error status code. +// +// a.HTTPError(myHandler, "POST", "/a/b/c", url.Values{"a": []string{"b", "c"}} +// +// Returns whether the assertion was successful (true) or not (false). +func (a *Assertions) HTTPError(handler http.HandlerFunc, method string, url string, values url.Values, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + HTTPError(a.t, handler, method, url, values, msgAndArgs...) +} + +// HTTPErrorf asserts that a specified handler returns an error status code. +// +// a.HTTPErrorf(myHandler, "POST", "/a/b/c", url.Values{"a": []string{"b", "c"}} +// +// Returns whether the assertion was successful (true, "error message %s", "formatted") or not (false). +func (a *Assertions) HTTPErrorf(handler http.HandlerFunc, method string, url string, values url.Values, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + HTTPErrorf(a.t, handler, method, url, values, msg, args...) +} + +// HTTPRedirect asserts that a specified handler returns a redirect status code. +// +// a.HTTPRedirect(myHandler, "GET", "/a/b/c", url.Values{"a": []string{"b", "c"}} +// +// Returns whether the assertion was successful (true) or not (false). +func (a *Assertions) HTTPRedirect(handler http.HandlerFunc, method string, url string, values url.Values, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + HTTPRedirect(a.t, handler, method, url, values, msgAndArgs...) +} + +// HTTPRedirectf asserts that a specified handler returns a redirect status code. +// +// a.HTTPRedirectf(myHandler, "GET", "/a/b/c", url.Values{"a": []string{"b", "c"}} +// +// Returns whether the assertion was successful (true, "error message %s", "formatted") or not (false). +func (a *Assertions) HTTPRedirectf(handler http.HandlerFunc, method string, url string, values url.Values, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + HTTPRedirectf(a.t, handler, method, url, values, msg, args...) +} + +// HTTPSuccess asserts that a specified handler returns a success status code. +// +// a.HTTPSuccess(myHandler, "POST", "http://www.google.com", nil) +// +// Returns whether the assertion was successful (true) or not (false). +func (a *Assertions) HTTPSuccess(handler http.HandlerFunc, method string, url string, values url.Values, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + HTTPSuccess(a.t, handler, method, url, values, msgAndArgs...) +} + +// HTTPSuccessf asserts that a specified handler returns a success status code. +// +// a.HTTPSuccessf(myHandler, "POST", "http://www.google.com", nil, "error message %s", "formatted") +// +// Returns whether the assertion was successful (true) or not (false). +func (a *Assertions) HTTPSuccessf(handler http.HandlerFunc, method string, url string, values url.Values, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + HTTPSuccessf(a.t, handler, method, url, values, msg, args...) +} + +// Implements asserts that an object is implemented by the specified interface. +// +// a.Implements((*MyInterface)(nil), new(MyObject)) +func (a *Assertions) Implements(interfaceObject interface{}, object interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Implements(a.t, interfaceObject, object, msgAndArgs...) +} + +// Implementsf asserts that an object is implemented by the specified interface. +// +// a.Implementsf((*MyInterface, "error message %s", "formatted")(nil), new(MyObject)) +func (a *Assertions) Implementsf(interfaceObject interface{}, object interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Implementsf(a.t, interfaceObject, object, msg, args...) +} + +// InDelta asserts that the two numerals are within delta of each other. +// +// a.InDelta(math.Pi, (22 / 7.0), 0.01) +func (a *Assertions) InDelta(expected interface{}, actual interface{}, delta float64, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + InDelta(a.t, expected, actual, delta, msgAndArgs...) +} + +// InDeltaMapValues is the same as InDelta, but it compares all values between two maps. Both maps must have exactly the same keys. +func (a *Assertions) InDeltaMapValues(expected interface{}, actual interface{}, delta float64, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + InDeltaMapValues(a.t, expected, actual, delta, msgAndArgs...) +} + +// InDeltaMapValuesf is the same as InDelta, but it compares all values between two maps. Both maps must have exactly the same keys. +func (a *Assertions) InDeltaMapValuesf(expected interface{}, actual interface{}, delta float64, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + InDeltaMapValuesf(a.t, expected, actual, delta, msg, args...) +} + +// InDeltaSlice is the same as InDelta, except it compares two slices. +func (a *Assertions) InDeltaSlice(expected interface{}, actual interface{}, delta float64, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + InDeltaSlice(a.t, expected, actual, delta, msgAndArgs...) +} + +// InDeltaSlicef is the same as InDelta, except it compares two slices. +func (a *Assertions) InDeltaSlicef(expected interface{}, actual interface{}, delta float64, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + InDeltaSlicef(a.t, expected, actual, delta, msg, args...) +} + +// InDeltaf asserts that the two numerals are within delta of each other. +// +// a.InDeltaf(math.Pi, (22 / 7.0, "error message %s", "formatted"), 0.01) +func (a *Assertions) InDeltaf(expected interface{}, actual interface{}, delta float64, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + InDeltaf(a.t, expected, actual, delta, msg, args...) +} + +// InEpsilon asserts that expected and actual have a relative error less than epsilon +func (a *Assertions) InEpsilon(expected interface{}, actual interface{}, epsilon float64, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + InEpsilon(a.t, expected, actual, epsilon, msgAndArgs...) +} + +// InEpsilonSlice is the same as InEpsilon, except it compares each value from two slices. +func (a *Assertions) InEpsilonSlice(expected interface{}, actual interface{}, epsilon float64, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + InEpsilonSlice(a.t, expected, actual, epsilon, msgAndArgs...) +} + +// InEpsilonSlicef is the same as InEpsilon, except it compares each value from two slices. +func (a *Assertions) InEpsilonSlicef(expected interface{}, actual interface{}, epsilon float64, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + InEpsilonSlicef(a.t, expected, actual, epsilon, msg, args...) +} + +// InEpsilonf asserts that expected and actual have a relative error less than epsilon +func (a *Assertions) InEpsilonf(expected interface{}, actual interface{}, epsilon float64, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + InEpsilonf(a.t, expected, actual, epsilon, msg, args...) +} + +// IsType asserts that the specified objects are of the same type. +func (a *Assertions) IsType(expectedType interface{}, object interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + IsType(a.t, expectedType, object, msgAndArgs...) +} + +// IsTypef asserts that the specified objects are of the same type. +func (a *Assertions) IsTypef(expectedType interface{}, object interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + IsTypef(a.t, expectedType, object, msg, args...) +} + +// JSONEq asserts that two JSON strings are equivalent. +// +// a.JSONEq(`{"hello": "world", "foo": "bar"}`, `{"foo": "bar", "hello": "world"}`) +func (a *Assertions) JSONEq(expected string, actual string, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + JSONEq(a.t, expected, actual, msgAndArgs...) +} + +// JSONEqf asserts that two JSON strings are equivalent. +// +// a.JSONEqf(`{"hello": "world", "foo": "bar"}`, `{"foo": "bar", "hello": "world"}`, "error message %s", "formatted") +func (a *Assertions) JSONEqf(expected string, actual string, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + JSONEqf(a.t, expected, actual, msg, args...) +} + +// Len asserts that the specified object has specific length. +// Len also fails if the object has a type that len() not accept. +// +// a.Len(mySlice, 3) +func (a *Assertions) Len(object interface{}, length int, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Len(a.t, object, length, msgAndArgs...) +} + +// Lenf asserts that the specified object has specific length. +// Lenf also fails if the object has a type that len() not accept. +// +// a.Lenf(mySlice, 3, "error message %s", "formatted") +func (a *Assertions) Lenf(object interface{}, length int, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Lenf(a.t, object, length, msg, args...) +} + +// Nil asserts that the specified object is nil. +// +// a.Nil(err) +func (a *Assertions) Nil(object interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Nil(a.t, object, msgAndArgs...) +} + +// Nilf asserts that the specified object is nil. +// +// a.Nilf(err, "error message %s", "formatted") +func (a *Assertions) Nilf(object interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Nilf(a.t, object, msg, args...) +} + +// NoError asserts that a function returned no error (i.e. `nil`). +// +// actualObj, err := SomeFunction() +// if a.NoError(err) { +// assert.Equal(t, expectedObj, actualObj) +// } +func (a *Assertions) NoError(err error, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NoError(a.t, err, msgAndArgs...) +} + +// NoErrorf asserts that a function returned no error (i.e. `nil`). +// +// actualObj, err := SomeFunction() +// if a.NoErrorf(err, "error message %s", "formatted") { +// assert.Equal(t, expectedObj, actualObj) +// } +func (a *Assertions) NoErrorf(err error, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NoErrorf(a.t, err, msg, args...) +} + +// NotContains asserts that the specified string, list(array, slice...) or map does NOT contain the +// specified substring or element. +// +// a.NotContains("Hello World", "Earth") +// a.NotContains(["Hello", "World"], "Earth") +// a.NotContains({"Hello": "World"}, "Earth") +func (a *Assertions) NotContains(s interface{}, contains interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotContains(a.t, s, contains, msgAndArgs...) +} + +// NotContainsf asserts that the specified string, list(array, slice...) or map does NOT contain the +// specified substring or element. +// +// a.NotContainsf("Hello World", "Earth", "error message %s", "formatted") +// a.NotContainsf(["Hello", "World"], "Earth", "error message %s", "formatted") +// a.NotContainsf({"Hello": "World"}, "Earth", "error message %s", "formatted") +func (a *Assertions) NotContainsf(s interface{}, contains interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotContainsf(a.t, s, contains, msg, args...) +} + +// NotEmpty asserts that the specified object is NOT empty. I.e. not nil, "", false, 0 or either +// a slice or a channel with len == 0. +// +// if a.NotEmpty(obj) { +// assert.Equal(t, "two", obj[1]) +// } +func (a *Assertions) NotEmpty(object interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotEmpty(a.t, object, msgAndArgs...) +} + +// NotEmptyf asserts that the specified object is NOT empty. I.e. not nil, "", false, 0 or either +// a slice or a channel with len == 0. +// +// if a.NotEmptyf(obj, "error message %s", "formatted") { +// assert.Equal(t, "two", obj[1]) +// } +func (a *Assertions) NotEmptyf(object interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotEmptyf(a.t, object, msg, args...) +} + +// NotEqual asserts that the specified values are NOT equal. +// +// a.NotEqual(obj1, obj2) +// +// Pointer variable equality is determined based on the equality of the +// referenced values (as opposed to the memory addresses). +func (a *Assertions) NotEqual(expected interface{}, actual interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotEqual(a.t, expected, actual, msgAndArgs...) +} + +// NotEqualf asserts that the specified values are NOT equal. +// +// a.NotEqualf(obj1, obj2, "error message %s", "formatted") +// +// Pointer variable equality is determined based on the equality of the +// referenced values (as opposed to the memory addresses). +func (a *Assertions) NotEqualf(expected interface{}, actual interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotEqualf(a.t, expected, actual, msg, args...) +} + +// NotNil asserts that the specified object is not nil. +// +// a.NotNil(err) +func (a *Assertions) NotNil(object interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotNil(a.t, object, msgAndArgs...) +} + +// NotNilf asserts that the specified object is not nil. +// +// a.NotNilf(err, "error message %s", "formatted") +func (a *Assertions) NotNilf(object interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotNilf(a.t, object, msg, args...) +} + +// NotPanics asserts that the code inside the specified PanicTestFunc does NOT panic. +// +// a.NotPanics(func(){ RemainCalm() }) +func (a *Assertions) NotPanics(f assert.PanicTestFunc, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotPanics(a.t, f, msgAndArgs...) +} + +// NotPanicsf asserts that the code inside the specified PanicTestFunc does NOT panic. +// +// a.NotPanicsf(func(){ RemainCalm() }, "error message %s", "formatted") +func (a *Assertions) NotPanicsf(f assert.PanicTestFunc, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotPanicsf(a.t, f, msg, args...) +} + +// NotRegexp asserts that a specified regexp does not match a string. +// +// a.NotRegexp(regexp.MustCompile("starts"), "it's starting") +// a.NotRegexp("^start", "it's not starting") +func (a *Assertions) NotRegexp(rx interface{}, str interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotRegexp(a.t, rx, str, msgAndArgs...) +} + +// NotRegexpf asserts that a specified regexp does not match a string. +// +// a.NotRegexpf(regexp.MustCompile("starts", "error message %s", "formatted"), "it's starting") +// a.NotRegexpf("^start", "it's not starting", "error message %s", "formatted") +func (a *Assertions) NotRegexpf(rx interface{}, str interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotRegexpf(a.t, rx, str, msg, args...) +} + +// NotSubset asserts that the specified list(array, slice...) contains not all +// elements given in the specified subset(array, slice...). +// +// a.NotSubset([1, 3, 4], [1, 2], "But [1, 3, 4] does not contain [1, 2]") +func (a *Assertions) NotSubset(list interface{}, subset interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotSubset(a.t, list, subset, msgAndArgs...) +} + +// NotSubsetf asserts that the specified list(array, slice...) contains not all +// elements given in the specified subset(array, slice...). +// +// a.NotSubsetf([1, 3, 4], [1, 2], "But [1, 3, 4] does not contain [1, 2]", "error message %s", "formatted") +func (a *Assertions) NotSubsetf(list interface{}, subset interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotSubsetf(a.t, list, subset, msg, args...) +} + +// NotZero asserts that i is not the zero value for its type. +func (a *Assertions) NotZero(i interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotZero(a.t, i, msgAndArgs...) +} + +// NotZerof asserts that i is not the zero value for its type. +func (a *Assertions) NotZerof(i interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + NotZerof(a.t, i, msg, args...) +} + +// Panics asserts that the code inside the specified PanicTestFunc panics. +// +// a.Panics(func(){ GoCrazy() }) +func (a *Assertions) Panics(f assert.PanicTestFunc, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Panics(a.t, f, msgAndArgs...) +} + +// PanicsWithValue asserts that the code inside the specified PanicTestFunc panics, and that +// the recovered panic value equals the expected panic value. +// +// a.PanicsWithValue("crazy error", func(){ GoCrazy() }) +func (a *Assertions) PanicsWithValue(expected interface{}, f assert.PanicTestFunc, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + PanicsWithValue(a.t, expected, f, msgAndArgs...) +} + +// PanicsWithValuef asserts that the code inside the specified PanicTestFunc panics, and that +// the recovered panic value equals the expected panic value. +// +// a.PanicsWithValuef("crazy error", func(){ GoCrazy() }, "error message %s", "formatted") +func (a *Assertions) PanicsWithValuef(expected interface{}, f assert.PanicTestFunc, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + PanicsWithValuef(a.t, expected, f, msg, args...) +} + +// Panicsf asserts that the code inside the specified PanicTestFunc panics. +// +// a.Panicsf(func(){ GoCrazy() }, "error message %s", "formatted") +func (a *Assertions) Panicsf(f assert.PanicTestFunc, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Panicsf(a.t, f, msg, args...) +} + +// Regexp asserts that a specified regexp matches a string. +// +// a.Regexp(regexp.MustCompile("start"), "it's starting") +// a.Regexp("start...$", "it's not starting") +func (a *Assertions) Regexp(rx interface{}, str interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Regexp(a.t, rx, str, msgAndArgs...) +} + +// Regexpf asserts that a specified regexp matches a string. +// +// a.Regexpf(regexp.MustCompile("start", "error message %s", "formatted"), "it's starting") +// a.Regexpf("start...$", "it's not starting", "error message %s", "formatted") +func (a *Assertions) Regexpf(rx interface{}, str interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Regexpf(a.t, rx, str, msg, args...) +} + +// Subset asserts that the specified list(array, slice...) contains all +// elements given in the specified subset(array, slice...). +// +// a.Subset([1, 2, 3], [1, 2], "But [1, 2, 3] does contain [1, 2]") +func (a *Assertions) Subset(list interface{}, subset interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Subset(a.t, list, subset, msgAndArgs...) +} + +// Subsetf asserts that the specified list(array, slice...) contains all +// elements given in the specified subset(array, slice...). +// +// a.Subsetf([1, 2, 3], [1, 2], "But [1, 2, 3] does contain [1, 2]", "error message %s", "formatted") +func (a *Assertions) Subsetf(list interface{}, subset interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Subsetf(a.t, list, subset, msg, args...) +} + +// True asserts that the specified value is true. +// +// a.True(myBool) +func (a *Assertions) True(value bool, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + True(a.t, value, msgAndArgs...) +} + +// Truef asserts that the specified value is true. +// +// a.Truef(myBool, "error message %s", "formatted") +func (a *Assertions) Truef(value bool, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Truef(a.t, value, msg, args...) +} + +// WithinDuration asserts that the two times are within duration delta of each other. +// +// a.WithinDuration(time.Now(), time.Now(), 10*time.Second) +func (a *Assertions) WithinDuration(expected time.Time, actual time.Time, delta time.Duration, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + WithinDuration(a.t, expected, actual, delta, msgAndArgs...) +} + +// WithinDurationf asserts that the two times are within duration delta of each other. +// +// a.WithinDurationf(time.Now(), time.Now(), 10*time.Second, "error message %s", "formatted") +func (a *Assertions) WithinDurationf(expected time.Time, actual time.Time, delta time.Duration, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + WithinDurationf(a.t, expected, actual, delta, msg, args...) +} + +// Zero asserts that i is the zero value for its type. +func (a *Assertions) Zero(i interface{}, msgAndArgs ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Zero(a.t, i, msgAndArgs...) +} + +// Zerof asserts that i is the zero value for its type. +func (a *Assertions) Zerof(i interface{}, msg string, args ...interface{}) { + if h, ok := a.t.(tHelper); ok { + h.Helper() + } + Zerof(a.t, i, msg, args...) +} diff --git a/vendor/github.com/stretchr/testify/require/require_forward.go.tmpl b/vendor/github.com/stretchr/testify/require/require_forward.go.tmpl new file mode 100644 index 000000000000..54124df1d3bb --- /dev/null +++ b/vendor/github.com/stretchr/testify/require/require_forward.go.tmpl @@ -0,0 +1,5 @@ +{{.CommentWithoutT "a"}} +func (a *Assertions) {{.DocInfo.Name}}({{.Params}}) { + if h, ok := a.t.(tHelper); ok { h.Helper() } + {{.DocInfo.Name}}(a.t, {{.ForwardedParams}}) +} diff --git a/vendor/github.com/stretchr/testify/require/requirements.go b/vendor/github.com/stretchr/testify/require/requirements.go new file mode 100644 index 000000000000..690583a8e03e --- /dev/null +++ b/vendor/github.com/stretchr/testify/require/requirements.go @@ -0,0 +1,29 @@ +package require + +// TestingT is an interface wrapper around *testing.T +type TestingT interface { + Errorf(format string, args ...interface{}) + FailNow() +} + +type tHelper interface { + Helper() +} + +// ComparisonAssertionFunc is a common function prototype when comparing two values. Can be useful +// for table driven tests. +type ComparisonAssertionFunc func(TestingT, interface{}, interface{}, ...interface{}) + +// ValueAssertionFunc is a common function prototype when validating a single value. Can be useful +// for table driven tests. +type ValueAssertionFunc func(TestingT, interface{}, ...interface{}) + +// BoolAssertionFunc is a common function prototype when validating a bool value. Can be useful +// for table driven tests. +type BoolAssertionFunc func(TestingT, bool, ...interface{}) + +// ValuesAssertionFunc is a common function prototype when validating an error value. Can be useful +// for table driven tests. +type ErrorAssertionFunc func(TestingT, error, ...interface{}) + +//go:generate go run ../_codegen/main.go -output-package=require -template=require.go.tmpl -include-format-funcs diff --git a/vendor/vendor.json b/vendor/vendor.json index b34647bbd03f..5221b45453f2 100644 --- a/vendor/vendor.json +++ b/vendor/vendor.json @@ -1361,6 +1361,12 @@ "version": "v1.2.0", "versionExact": "v1.2.0" }, + { + "checksumSHA1": "wnEANt4k5X/KGwoFyfSSnpxULm4=", + "path": "github.com/stretchr/testify/require", + "revision": "f35b8ab0b5a2cef36673838d662e249dd9c94686", + "revisionTime": "2018-05-06T18:05:49Z" + }, { "checksumSHA1": "CpcG17Q/0k1g2uy8AL26Uu7TouU=", "path": "github.com/theckman/go-flock", From 182bdddaa575f7ff53b5c8bbab908c670897fc74 Mon Sep 17 00:00:00 2001 From: Shaunak Kashyap Date: Thu, 19 Jul 2018 11:40:58 -0700 Subject: [PATCH 09/34] Only fetch shard metrics from master node (#7635) This PR makes it so that the `elasticsearch/shard` metricset only fetches information from the Elasticsearch node if that node is the master node. --- metricbeat/module/elasticsearch/shard/shard.go | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/metricbeat/module/elasticsearch/shard/shard.go b/metricbeat/module/elasticsearch/shard/shard.go index 941cf48ef5ac..bdec76b4e805 100644 --- a/metricbeat/module/elasticsearch/shard/shard.go +++ b/metricbeat/module/elasticsearch/shard/shard.go @@ -18,7 +18,10 @@ package shard import ( + "fmt" + "github.com/elastic/beats/libbeat/common/cfgwarn" + "github.com/elastic/beats/libbeat/logp" "github.com/elastic/beats/metricbeat/mb" "github.com/elastic/beats/metricbeat/module/elasticsearch" ) @@ -32,7 +35,6 @@ func init() { } const ( - // Get the stats from the local node statePath = "/_cluster/state/version,master_node,routing_table" ) @@ -55,6 +57,18 @@ func New(base mb.BaseMetricSet) (mb.MetricSet, error) { // Fetch methods implements the data gathering and data conversion to the right format func (m *MetricSet) Fetch(r mb.ReporterV2) { + isMaster, err := elasticsearch.IsMaster(m.HTTP, m.HostData().SanitizedURI+statePath) + if err != nil { + r.Error(fmt.Errorf("Error fetch master info: %s", err)) + return + } + + // Not master, no event sent + if !isMaster { + logp.Debug("elasticsearch", "Trying to fetch shard stats from a non master node.") + return + } + content, err := m.HTTP.FetchContent() if err != nil { r.Error(err) From e5791d2b6f715c9eaa32581f28b5fa6406bb727e Mon Sep 17 00:00:00 2001 From: Shaunak Kashyap Date: Thu, 19 Jul 2018 12:43:42 -0700 Subject: [PATCH 10/34] Create (X-Pack Monitoring) stats metricset for Kibana module (#7525) This PR takes the `stats` metricset of the `kibana` Metricbeat module and makes it ship documents to `.monitoring-kibana-6-mb-%{YYYY.MM.DD}` indices, while preserving the current format/mapping expected by docs in these indices. This will ensure that current consumers of the data in these indices, viz. the X-Pack Monitoring UI and the Telemetry shipping module in Kibana, will continue to work as-is. --- metricbeat/docs/fields.asciidoc | 157 ++++++--------- metricbeat/docs/modules/kibana.asciidoc | 1 + metricbeat/helper/xpack/xpack.go | 4 +- metricbeat/helper/xpack/xpack_test.go | 11 +- metricbeat/mb/parse/url.go | 33 ++- metricbeat/mb/parse/url_test.go | 4 + metricbeat/metricbeat.reference.yml | 1 + .../module/kibana/_meta/config.reference.yml | 1 + metricbeat/module/kibana/_meta/config.yml | 1 + metricbeat/module/kibana/config.go | 30 +++ metricbeat/module/kibana/fields.go | 2 +- metricbeat/module/kibana/kibana.go | 32 +++ metricbeat/module/kibana/kibana_test.go | 52 +++++ .../module/kibana/stats/_meta/data.json | 69 +++---- .../module/kibana/stats/_meta/fields.yml | 144 ++++++-------- .../kibana/stats/_meta/test/stats.700.json | 185 ++++++++++++----- metricbeat/module/kibana/stats/data.go | 101 +++++----- metricbeat/module/kibana/stats/data_test.go | 2 +- metricbeat/module/kibana/stats/data_xpack.go | 188 ++++++++++++++++++ .../module/kibana/stats/data_xpack_test.go | 47 +++++ metricbeat/module/kibana/stats/stats.go | 31 ++- metricbeat/modules.d/kibana.yml.disabled | 1 + 22 files changed, 753 insertions(+), 344 deletions(-) create mode 100644 metricbeat/module/kibana/config.go create mode 100644 metricbeat/module/kibana/kibana.go create mode 100644 metricbeat/module/kibana/kibana_test.go create mode 100644 metricbeat/module/kibana/stats/data_xpack.go create mode 100644 metricbeat/module/kibana/stats/data_xpack_test.go diff --git a/metricbeat/docs/fields.asciidoc b/metricbeat/docs/fields.asciidoc index ebc748e47433..0b812bf59319 100644 --- a/metricbeat/docs/fields.asciidoc +++ b/metricbeat/docs/fields.asciidoc @@ -6681,12 +6681,12 @@ Kibana stats and run-time metrics. -*`kibana.stats.cluster_uuid`*:: +*`kibana.stats.uuid`*:: + -- type: keyword -UUID of the Elasticsearch cluster to which Kibana connects. +Kibana instance UUID -- @@ -6694,246 +6694,203 @@ UUID of the Elasticsearch cluster to which Kibana connects. *`kibana.stats.name`*:: + -- -type: keyword +type: text -Kibana instance name. +Kibana instance name -- -*`kibana.stats.uuid`*:: +*`kibana.stats.index`*:: + -- type: keyword -Kibana instance uuid. +Name of Kibana's internal index -- -*`kibana.stats.version.number`*:: +*`kibana.stats.host.name`*:: + -- type: keyword -Kibana version number. +Kibana instance hostname -- -*`kibana.stats.status.overall.state`*:: +*`kibana.stats.transport_address`*:: + -- type: keyword -Kibana overall state. +Kibana server's hostname and port -- -[float] -== process fields - -Kibana process metrics. - - - -[float] -== mem fields - -Memory usage metrics of the Kibana instance. - - - -*`kibana.stats.process.mem.heap.max.bytes`*:: +*`kibana.stats.version`*:: + -- -type: long - -format: bytes +type: keyword -Total amount of heap memory used by V8. +Kibana version -- -*`kibana.stats.process.mem.heap.used.bytes`*:: +*`kibana.stats.snapshot`*:: + -- -type: long - -format: bytes +type: boolean -Amount of memory in use by V8. +Whether the Kibana build is a snapshot build -- -*`kibana.stats.process.mem.resident_set_size.bytes`*:: +*`kibana.stats.status`*:: + -- -type: long - -format: bytes +type: keyword -The amount of space occupied in main memory for the process. Includes heap, code segment, and stack. +Kibana instance's health status -- -*`kibana.stats.process.mem.external.bytes`*:: +*`kibana.stats.concurrent_connections`*:: + -- type: long -format: bytes - -Memory usage of C++ objects bound to JavaScript objects managed by V8. +Number of client connections made to the server. Note that browsers can send multiple simultaneous connections to request mulitple server assets at once, and they can re-use established connections. -- -*`kibana.stats.process.pid`*:: -+ --- -type: long +[float] +== process fields -Process ID of the Kibana instance. +Process metrics --- -*`kibana.stats.process.uptime.ms`*:: +*`kibana.stats.process.event_loop_delay.ms`*:: + -- -type: long +type: scaled_float -Amount of time that the Kibana process has been running in milliseconds. +Event loop delay in milliseconds -- [float] -== response_times fields +== memory.heap fields -HTTP Server response time metrics +Process heap metrics -*`kibana.stats.response_times.avg.ms`*:: +*`kibana.stats.process.memory.heap.total.bytes`*:: + -- type: long -Accumulated averages for response times, for all responses in a 5-second time window. +format: bytes + +Total heap allocated to process in bytes -- -*`kibana.stats.response_times.max.ms`*:: +*`kibana.stats.process.memory.heap.used.bytes`*:: + -- type: long -Accumulated maximums for response times, for all responses in a 5-second time window. - - --- - -[float] -== requests fields - -HTTP Server request metrics - - - -*`kibana.stats.requests.status_codes`*:: -+ --- -type: object +format: bytes -Key-value pairs for each status code sent by the server, and the number of times it sent that code. +Heap used by process in bytes -- -*`kibana.stats.requests.total`*:: +*`kibana.stats.process.memory.heap.size_limit.bytes`*:: + -- type: long -Total number of requests sent by the server. - - --- - -*`kibana.stats.requests.disconnects`*:: -+ --- -type: long +format: bytes -Total number of client disconnects encountered by the server. +Max. old space size allocated to Node.js process, in bytes -- -*`kibana.stats.concurrent_connections`*:: +*`kibana.stats.process.memory.heap.uptime.ms`*:: + -- type: long -Number of client connections made to the server. Note that browsers can send multiple simultaneous connections to request multiple server assets at once, and they can re-use established connections. +Uptime of process in milliseconds -- [float] -== sockets fields +== request fields -HTTP Web Sockets metrics +Request count metrics -[float] -== http fields +*`kibana.stats.request.disconnects`*:: ++ +-- +type: long -Web Sockets over plaintext HTTP +Number of requests that were disconnected +-- -*`kibana.stats.sockets.http.total`*:: +*`kibana.stats.request.total`*:: + -- type: long -Number of HTTP web socket connections established +Total number of requests -- [float] -== https fields +== response_time fields -Web Sockets over encrypted HTTPS +Response times metrics -*`kibana.stats.sockets.https.total`*:: +*`kibana.stats.response_time.avg.ms`*:: + -- type: long -Number of HTTPS web socket connections established +Average response time in milliseconds -- -*`kibana.stats.event_loop_delay`*:: +*`kibana.stats.response_time.max.ms`*:: + -- type: long -Node event loop delay calculated with internal benchmarking. +Maximum response time in milliseconds -- diff --git a/metricbeat/docs/modules/kibana.asciidoc b/metricbeat/docs/modules/kibana.asciidoc index 14bd52bc9cca..0aa7ce4c2425 100644 --- a/metricbeat/docs/modules/kibana.asciidoc +++ b/metricbeat/docs/modules/kibana.asciidoc @@ -25,6 +25,7 @@ metricbeat.modules: metricsets: ["status"] period: 10s hosts: ["localhost:5601"] + basepath: "" enabled: true ---- diff --git a/metricbeat/helper/xpack/xpack.go b/metricbeat/helper/xpack/xpack.go index 4c7363c8f405..f876be3d8262 100644 --- a/metricbeat/helper/xpack/xpack.go +++ b/metricbeat/helper/xpack/xpack.go @@ -19,7 +19,6 @@ package xpack import ( "fmt" - "time" ) // Product supported by X-Pack Monitoring @@ -57,8 +56,7 @@ func (p Product) String() string { // MakeMonitoringIndexName method returns the name of the monitoring index for // a given product { elasticsearch, kibana, logstash, beats } func MakeMonitoringIndexName(product Product) string { - today := time.Now().UTC().Format("2006.01.02") const version = "6" - return fmt.Sprintf(".monitoring-%v-%v-mb-%v", product, version, today) + return fmt.Sprintf(".monitoring-%v-%v-mb", product, version) } diff --git a/metricbeat/helper/xpack/xpack_test.go b/metricbeat/helper/xpack/xpack_test.go index 841e6730c666..c6aa2cd5f1fe 100644 --- a/metricbeat/helper/xpack/xpack_test.go +++ b/metricbeat/helper/xpack/xpack_test.go @@ -20,14 +20,11 @@ package xpack import ( "fmt" "testing" - "time" "github.com/stretchr/testify/assert" ) func TestMakeMonitoringIndexName(t *testing.T) { - today := time.Now().UTC().Format("2006.01.02") - tests := []struct { Name string Product Product @@ -36,22 +33,22 @@ func TestMakeMonitoringIndexName(t *testing.T) { { "Elasticsearch monitoring index", Elasticsearch, - fmt.Sprintf(".monitoring-es-6-mb-%v", today), + ".monitoring-es-6-mb", }, { "Kibana monitoring index", Kibana, - fmt.Sprintf(".monitoring-kibana-6-mb-%v", today), + ".monitoring-kibana-6-mb", }, { "Logstash monitoring index", Logstash, - fmt.Sprintf(".monitoring-logstash-6-mb-%v", today), + ".monitoring-logstash-6-mb", }, { "Beats monitoring index", Beats, - fmt.Sprintf(".monitoring-beats-6-mb-%v", today), + ".monitoring-beats-6-mb", }, } diff --git a/metricbeat/mb/parse/url.go b/metricbeat/mb/parse/url.go index af3eb172640d..c3d719368778 100644 --- a/metricbeat/mb/parse/url.go +++ b/metricbeat/mb/parse/url.go @@ -21,6 +21,7 @@ import ( "fmt" "net" "net/url" + p "path" "strings" "github.com/elastic/beats/metricbeat/mb" @@ -31,12 +32,13 @@ import ( // URLHostParserBuilder builds a tailored HostParser for used with host strings // that are URLs. type URLHostParserBuilder struct { - PathConfigKey string - DefaultPath string - DefaultUsername string - DefaultPassword string - DefaultScheme string - QueryParams string + BasePathConfigKey string + PathConfigKey string + DefaultPath string + DefaultUsername string + DefaultPassword string + DefaultScheme string + QueryParams string } // Build returns a new HostParser function whose behavior is influenced by the @@ -49,7 +51,7 @@ func (b URLHostParserBuilder) Build() mb.HostParser { return mb.HostData{}, err } - var user, pass, path string + var user, pass, path, basePath string t, ok := conf["username"] if ok { user, ok = t.(string) @@ -77,8 +79,23 @@ func (b URLHostParserBuilder) Build() mb.HostParser { } else { path = b.DefaultPath } + // Normalize path + path = strings.Trim(path, "/") - return ParseURL(host, b.DefaultScheme, user, pass, path, b.QueryParams) + t, ok = conf[b.BasePathConfigKey] + if ok { + basePath, ok = t.(string) + if !ok { + return mb.HostData{}, errors.Errorf("'%v' config for module %v is not a string", b.BasePathConfigKey, module.Name()) + } + } + // Normalize basepath + basePath = strings.Trim(basePath, "/") + + // Combine paths and normalize + fullPath := strings.Trim(p.Join(basePath, path), "/") + + return ParseURL(host, b.DefaultScheme, user, pass, fullPath, b.QueryParams) } } diff --git a/metricbeat/mb/parse/url_test.go b/metricbeat/mb/parse/url_test.go index 4f08aa236973..3d4fede58ffe 100644 --- a/metricbeat/mb/parse/url_test.go +++ b/metricbeat/mb/parse/url_test.go @@ -114,6 +114,10 @@ func TestURLHostParserBuilder(t *testing.T) { {map[string]interface{}{}, URLHostParserBuilder{DefaultPath: "/default"}, "http://example.com/default"}, {map[string]interface{}{"username": "guest"}, URLHostParserBuilder{}, "http://guest@example.com"}, {map[string]interface{}{"username": "guest", "password": "secret"}, URLHostParserBuilder{}, "http://guest:secret@example.com"}, + {map[string]interface{}{"basepath": "/foo"}, URLHostParserBuilder{BasePathConfigKey: "basepath", DefaultPath: "/default"}, "http://example.com/foo/default"}, + {map[string]interface{}{"basepath": "foo/"}, URLHostParserBuilder{BasePathConfigKey: "basepath", DefaultPath: "/default"}, "http://example.com/foo/default"}, + {map[string]interface{}{"basepath": "/foo/"}, URLHostParserBuilder{BasePathConfigKey: "basepath", DefaultPath: "/default"}, "http://example.com/foo/default"}, + {map[string]interface{}{"basepath": "foo"}, URLHostParserBuilder{BasePathConfigKey: "basepath", DefaultPath: "/default"}, "http://example.com/foo/default"}, } for _, test := range cases { diff --git a/metricbeat/metricbeat.reference.yml b/metricbeat/metricbeat.reference.yml index d9f84bdd57a3..4acd3a0ffb30 100644 --- a/metricbeat/metricbeat.reference.yml +++ b/metricbeat/metricbeat.reference.yml @@ -351,6 +351,7 @@ metricbeat.modules: metricsets: ["status"] period: 10s hosts: ["localhost:5601"] + basepath: "" enabled: true #----------------------------- Kubernetes Module ----------------------------- diff --git a/metricbeat/module/kibana/_meta/config.reference.yml b/metricbeat/module/kibana/_meta/config.reference.yml index 05d0b4d3dbd1..328a5e0b57ac 100644 --- a/metricbeat/module/kibana/_meta/config.reference.yml +++ b/metricbeat/module/kibana/_meta/config.reference.yml @@ -2,4 +2,5 @@ metricsets: ["status"] period: 10s hosts: ["localhost:5601"] + basepath: "" enabled: true diff --git a/metricbeat/module/kibana/_meta/config.yml b/metricbeat/module/kibana/_meta/config.yml index 838670f8b629..f997985d3c2c 100644 --- a/metricbeat/module/kibana/_meta/config.yml +++ b/metricbeat/module/kibana/_meta/config.yml @@ -3,5 +3,6 @@ # - status period: 10s hosts: ["localhost:5601"] + #basepath: "" #username: "user" #password: "secret" diff --git a/metricbeat/module/kibana/config.go b/metricbeat/module/kibana/config.go new file mode 100644 index 000000000000..748ba6bb5e31 --- /dev/null +++ b/metricbeat/module/kibana/config.go @@ -0,0 +1,30 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package kibana + +// Config defines the structure for the Kibana module configuration options +type Config struct { + XPackEnabled bool `config:"xpack.enabled"` +} + +// DefaultConfig returns the default configuration for the Kibana module +func DefaultConfig() Config { + return Config{ + XPackEnabled: false, + } +} diff --git a/metricbeat/module/kibana/fields.go b/metricbeat/module/kibana/fields.go index f8c9dec28a08..68bf480e11b0 100644 --- a/metricbeat/module/kibana/fields.go +++ b/metricbeat/module/kibana/fields.go @@ -31,5 +31,5 @@ func init() { // Asset returns asset data func Asset() string { - return "eJzsWE1v20YQvftXDHyNpVuBQocCRVqgaZAgqJz2UBTCcjkSt9oPdmcoWf31xSwpiaJJWZHpwAHKgxGRmzdvZufj7U5gjbsZrE2mvLoBYMMWZ3D7Pr24vQHIkXQ0JZvgZ/DDDQBA/RFcyCuLNwBUhMgLHfzSrGawVJbkbUSLinAGGbJAEzIbv6IZ/HlLZG//ugFYGrQ5zRLqBLxy2OIiD+9KnMEqhqps3vTwOcVpYxErpsPbPrhByPppXE04oHwOsfITNg7BIUejadpa3vV4/3TZtRlqWxFjXFSVyU8W7MmucbcNsfvtDGV5Pn9+9xOEJXCB8LNVxEYTqqiLvT3gANvC6GLvoQ7eo+YTf44s5e947BqTxhMrrzGh99sdNypdu4Leb3eDkUzwU1+5DOPoDBp4qOH7KUjKVTQNG4zK2qn8HH8LGvRkbGALyhg0EvWa7hbS5YYb1L4qgoGKaZNy6B59O0fqAmLyfEAX4g4qUqtDge/LqJM8XcbnWLeZF6jKqVMP02zH2I3qqSM2+NXAgmWITvEMzoFc4K8894GVBeVC5Vl8FYIS3zoQmEO2g9+/73O345QsfjVe/Xjwp3HFePHmEmciksnR84KQF2T+xVfj1H2BrY2iUmmEoHVVGszFQafkT+3vMsSUtk2hTeGd17bKkdJm3YEOOQLhyqHnuzTZiJVenw8NPjBGr+yrichJwYYlvH3zBkL2twwyyELlc5lzv6qNmie0wzenvFoN5/ah9z2aPk86eAHxT03vO47oJ3vLYR6Woj2mri9sz6V1LJmkb7hQ3Ca379iFIsgQvSghb/wqJZ6x1hDq4PMBARGRyuAJF4I92jD55f7+E8wxbjAeLEBbnX3hWFGb1QvFVuvKVVYx5qBk5q6QUomesKa79E4G8v49SXgVfDepo1s7tzU+D9vhLJHx8uJuOPVgXOVGduOYL/9USPxCmZKwr8yRWpctpH8Oh7juM9cF+T3uJhtlK4RSmVjHF5UuGsv7zu1ZupcUKCW36iYuv2tVuS9kAsP18lTR8r+HM4dFDLxA4tQi40hsv709fgyTyw3tTylfgaK2Rri1jAJ6LS0SYz05hjgfjnbB6ypGkRINhAm+P6N7aD9B+WOXaMsEOJWjTL4WQ/gYuGnqWQxbwkiglZcNyMFVlk1pEcjIP5XHkBLtiMjhWDaHxXU5KSKUwzFD8BoPabhL8BEnIruQWGXWUIF5G3bg5BP0Gkcu/T8wg3mNe2XdF8x9p4pnnznazOQ4BqVVxjM+cGJ+5TFjqJDhEoF2ofg6pmAK8RazZutOMqe19WdjO1zTYwYXvY67UuaXcJ5/M9Gdf2l4D5J9I/3HhlAucrRqN1b7kSGUsEGwIWGDVlY38mBruADJYzkvQIZeF07FtfGrae8tXfWsa7p5PRrrvXvmjdz/d12jMviW7rr6J8PVk+dDc4P0KC3hgnlzkXqAEYTP29pKy+DwiIanJfr5iF3I6bdGa8hemXR7fe1923nRCCM27K6APFo+J3q6fL/GaHkkddvk/gsAAP//Ii6tlQ==" + return "eJzEmM9u4zYQxu9+ikEue9noAXwoULQFWhQJim2DHorCGIljiw1FqpyRY/fpC1KSI8tUrOzKiA5BItnf9+Nw/oi5h2c6ruFZ52hxBSBaDK3h7td4424FoIgLr2vRzq7huxUAQPsQKqcaQysALp2XTeHsVu/WsEXD4a4nQ8i0hpwkSDOJaLvjNfx1x2zu/l4BbDUZxeuoeg8WKxqwhEuONa1h511Td3cSPOc6Qy0WFD7dTclNSrZXt9SoA2gV+Mbei64IKhKvC84GHx+vuL/GdEPCptHq7EEP+UzHF+fHz95AHeBqy4K2IHh6+uXHpG34mbQVOsi3eV5I957aKjost9ZHrAjctvP/xKCtkLdoEkY9QulYssm1LxLyYDEZAvFouQ7Vgkp5Yl6cg8nvyX/iE0fM2mCZBNqTZ+3s4hgp3VNRWqy5dOM0a01z5wzhGOiK6Z8lSUkepKQeIG+0UaAZ8OTX3ksjCUqz/Gb0SRG2g9BImTLqGQpni8Z7srGVWiqCeJrJOLt7Z7E0VU4+lEthNFmBgQVUqAjExfC1+ZPBoxMCKVEg9+6FyTMUaIHJKqgaI7o2BKzDr2jJNXymKA48/dsQS/iwlvjhqAzITKGXCjhb0OeYnlLSMcp7um+YgFgwN5pLUkPZLBm32rtiqpLGnX5GpH5r5fr+PnqeauWvKLQPu2ecqzeKDB6zavz9HowLNKQ2W+NwXAdXCQF+Cj4QfCD6gLZQaWM0U+GsGpv2eBVVzh+zknAck7fiNYOnj1lQngjcVOgGvdEJmiw/Cl1+943Ej9LOVyhrmPry1QUA/BHc2wWgMa5AIRXSuMuuEOG0+mmQM6kPo/85cAcCyI/zkVn/RxujKy0fBv6AhwycUcA1FhSJzuP/6BRl/3C/qM8zNqIO72ep0ruynBm4T1E7tNFBkCcrryfqWuFSHQrgS9dbC9dYeVeneoVSmrvWeotAvc6bbvHcDpMX8jSwpvFcHbWDG5C1hW4v+CZ2jmtnmTZh25favy+dKATR9w2aVzLc726T4t/vyeOOTkuPlFcGzGDE4OE2WA940FVTzcSafK979wHw96jQbcc3nvVue/AI6uk3pNueMYN62rc7BGRtsd3qjNHVchqhTYDMhaQ2Jgt/Lr8FnXo0m9iCdJF/dQt5aOUu0xJmtI5ZBw1YoGZ/aF0GhtNv83A5L6eR0q+ps5j60Rn2SrOM/oPTX1MhhNkDFK7FbyYvJEbWcH6+HVGYMVBvSXoG938AAAD//7lENR0=" } diff --git a/metricbeat/module/kibana/kibana.go b/metricbeat/module/kibana/kibana.go new file mode 100644 index 000000000000..43f1f711a06c --- /dev/null +++ b/metricbeat/module/kibana/kibana.go @@ -0,0 +1,32 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package kibana + +import ( + "fmt" + + "github.com/elastic/beats/metricbeat/mb" +) + +// ReportErrorForMissingField reports and returns an error message for the given +// field being missing in API response received from Kibana +func ReportErrorForMissingField(field string, r mb.ReporterV2) error { + err := fmt.Errorf("Could not find field '%v' in Kibana stats API response", field) + r.Error(err) + return err +} diff --git a/metricbeat/module/kibana/kibana_test.go b/metricbeat/module/kibana/kibana_test.go new file mode 100644 index 000000000000..543aabda2826 --- /dev/null +++ b/metricbeat/module/kibana/kibana_test.go @@ -0,0 +1,52 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package kibana + +import ( + "fmt" + "testing" + + "github.com/stretchr/testify/assert" + + "github.com/elastic/beats/metricbeat/mb" +) + +type MockReporterV2 struct { + mb.ReporterV2 +} + +func (MockReporterV2) Event(event mb.Event) bool { + return true +} + +var currentErr error // This hack is necessary because the Error method below cannot receive the type *MockReporterV2 + +func (m MockReporterV2) Error(err error) bool { + currentErr = err + return true +} + +func TestReportErrorForMissingField(t *testing.T) { + field := "some.missing.field" + r := MockReporterV2{} + err := ReportErrorForMissingField(field, r) + + expectedError := fmt.Errorf("Could not find field '%v' in Kibana stats API response", field) + assert.Equal(t, expectedError, err) + assert.Equal(t, expectedError, currentErr) +} diff --git a/metricbeat/module/kibana/stats/_meta/data.json b/metricbeat/module/kibana/stats/_meta/data.json index db7040214857..7097d36ba424 100644 --- a/metricbeat/module/kibana/stats/_meta/data.json +++ b/metricbeat/module/kibana/stats/_meta/data.json @@ -6,65 +6,53 @@ }, "elasticsearch": { "cluster": { - "id": "PKEQ1V5kT4yPng_sgiqF9g" + "id": "njqU4EQaTROIDlWPeUMQyw" } }, "kibana": { "stats": { - "concurrent_connections": 17, - "event_loop_delay": 718.5184001922607, - "name": "kibana", + "concurrent_connections": 6, + "host": { + "name": "localhost" + }, + "index": "Shaunaks-MBP-2", + "name": "Shaunaks-MBP-2", "process": { + "event_loop_delay": { + "ms": 0.23628300055861473 + }, "memory": { - "external": { - "bytes": 1969666 - }, "heap": { - "max": { - "bytes": 200028160 + "size_limit": { + "bytes": 1501560832 + }, + "total": { + "bytes": 215003136 }, "used": { - "bytes": 138875320 + "bytes": 185343400 } - }, - "resident_set_size": { - "bytes": 247865344 } }, - "pid": 1, "uptime": { - "ms": 260863 + "ms": 1343714 } }, - "requests": { + "request": { "disconnects": 0, - "total": 91 + "total": 0 }, - "response_times": { - "avg": { - "ms": 1347.2500000000002 - }, + "response_time": { + "avg": {}, "max": { - "ms": 4293 - } - }, - "sockets": { - "http": { - "total": 56 - }, - "https": { - "total": 0 + "ms": 0 } }, - "status": { - "overall": { - "state": "green" - } - }, - "uuid": "b4b34609-03b3-463c-8699-17109e72df70", - "version": { - "number": "7.0.0-alpha1" - } + "snapshot": false, + "status": "green", + "transport_address": "localhost:5601", + "uuid": "5b2de169-2785-441b-ae8c-186a1936b17d", + "version": "7.0.0-alpha1" } }, "metricset": { @@ -73,6 +61,9 @@ "name": "stats", "rtt": 115 }, + "process": { + "pid": 20173 + }, "service": { "name": "kibana" } diff --git a/metricbeat/module/kibana/stats/_meta/fields.yml b/metricbeat/module/kibana/stats/_meta/fields.yml index 6360ae469483..58da702cc9fc 100644 --- a/metricbeat/module/kibana/stats/_meta/fields.yml +++ b/metricbeat/module/kibana/stats/_meta/fields.yml @@ -4,122 +4,98 @@ Kibana stats and run-time metrics. release: beta fields: - - name: cluster_uuid + - name: uuid type: keyword description: > - UUID of the Elasticsearch cluster to which Kibana connects. + Kibana instance UUID - name: name + type: text + description: > + Kibana instance name + - name: index type: keyword description: > - Kibana instance name. - - name: uuid + Name of Kibana's internal index + - name: host.name + type: keyword + description: > + Kibana instance hostname + - name: transport_address type: keyword description: > - Kibana instance uuid. - - name: version.number + Kibana server's hostname and port + - name: version type: keyword description: > - Kibana version number. - - name: status.overall.state + Kibana version + - name: snapshot + type: boolean + description: > + Whether the Kibana build is a snapshot build + - name: status type: keyword description: > - Kibana overall state. + Kibana instance's health status + - name: concurrent_connections + type: long + description: > + Number of client connections made to the server. Note that browsers can send multiple simultaneous connections to request mulitple server assets at once, and they can re-use established connections. - name: process type: group description: > - Kibana process metrics. + Process metrics fields: - - name: mem - type: group - description: > - Memory usage metrics of the Kibana instance. - fields: - - name: heap.max.bytes - type: long - format: bytes - description: > - Total amount of heap memory used by V8. - - name: heap.used.bytes - type: long - format: bytes - description: > - Amount of memory in use by V8. - - name: resident_set_size.bytes - type: long - format: bytes - description: > - The amount of space occupied in main memory for the process. Includes heap, code segment, and stack. - - name: external.bytes - type: long - format: bytes - description: > - Memory usage of C++ objects bound to JavaScript objects managed by V8. - - name: pid + - name: event_loop_delay.ms + type: scaled_float + description: > + Event loop delay in milliseconds + - name: memory.heap + type: group + description: > + Process heap metrics + fields: + - name: total.bytes type: long + format: bytes description: > - Process ID of the Kibana instance. - - name: uptime.ms + Total heap allocated to process in bytes + - name: used.bytes type: long + format: bytes description: > - Amount of time that the Kibana process has been running in milliseconds. - - name: response_times - type: group - description: > - HTTP Server response time metrics - fields: - - name: avg.ms + Heap used by process in bytes + - name: size_limit.bytes type: long + format: bytes description: > - Accumulated averages for response times, for all responses in a 5-second time window. - - name: max.ms + Max. old space size allocated to Node.js process, in bytes + - name: uptime.ms type: long description: > - Accumulated maximums for response times, for all responses in a 5-second time window. - - name: requests + Uptime of process in milliseconds + - name: request type: group description: > - HTTP Server request metrics + Request count metrics fields: - - name: status_codes - type: object - description: > - Key-value pairs for each status code sent by the server, and the number of times it sent that code. - - name: total + - name: disconnects type: long description: > - Total number of requests sent by the server. - - name: disconnects + Number of requests that were disconnected + - name: total type: long description: > - Total number of client disconnects encountered by the server. - - name: concurrent_connections - type: long - description: > - Number of client connections made to the server. Note that browsers can send multiple simultaneous connections to request multiple server assets at once, and they can re-use established connections. - - name: sockets + Total number of requests + - name: response_time type: group description: > - HTTP Web Sockets metrics + Response times metrics fields: - - name: http - type: group + - name: avg.ms + type: long description: > - Web Sockets over plaintext HTTP - fields: - - name: total - type: long - description: > - Number of HTTP web socket connections established - - name: https - type: group + Average response time in milliseconds + - name: max.ms + type: long description: > - Web Sockets over encrypted HTTPS - fields: - - name: total - type: long - description: > - Number of HTTPS web socket connections established - - name: event_loop_delay - type: long - description: > - Node event loop delay calculated with internal benchmarking. + Maximum response time in milliseconds diff --git a/metricbeat/module/kibana/stats/_meta/test/stats.700.json b/metricbeat/module/kibana/stats/_meta/test/stats.700.json index 01ad405e54a6..0f74c8b8dbd9 100644 --- a/metricbeat/module/kibana/stats/_meta/test/stats.700.json +++ b/metricbeat/module/kibana/stats/_meta/test/stats.700.json @@ -1,53 +1,144 @@ { - "cluster_uuid": "G279hqGeSDqjj_OgBq6wUw", - "name": "ruflin", - "uuid": "3a64c6a4-b758-41b4-9564-375ca3165039", - "version": { - "number": "6.4.0" - }, - "status": { - "overall": { - "state": "green" - } - }, - "response_times": { - "avg_in_millis": 401, - "max_in_millis": 411 - }, - "requests": { - "status_codes": {} - }, - "concurrent_connections": 0, - "sockets": { - "http": { - "total": 76 + "kibana":{ + "uuid":"5b2de169-2785-441b-ae8c-186a1936b17d", + "name":"Shaunaks-MBP-2", + "index":".kibana", + "host":"localhost", + "transport_address":"localhost:5601", + "version":"7.0.0-alpha1", + "snapshot":false, + "status":"green" }, - "https": { - "total": 0 - } - }, - "event_loop_delay": 46.37134699523449, - "process": { - "mem": { - "heap_max_in_bytes": 171405312, - "heap_used_in_bytes": 143607728, - "resident_set_size_in_bytes": 237985792, - "external_in_bytes": 2075915 + "last_updated":"2018-07-18T00:32:00.948Z", + "collection_interval_ms":5000, + "process":{ + "memory":{ + "heap":{ + "total_bytes":223391744, + "used_bytes":198413592, + "size_limit":1501560832 + }, + "resident_set_size_bytes":347242496 + }, + "event_loop_delay":0.25226891040802, + "pid":46426, + "uptime_ms":1753889 }, - "pid": 18204, - "uptime_ms": 584494 - }, - "os": { - "cpu": { - "load_average": { - "1m": 1.96044921875, - "5m": 2.00732421875, - "15m": 2.07470703125 + "os":{ + "load":{ + "1m":3.50634765625, + "5m":3.76904296875, + "15m":3.54833984375 + }, + "memory":{ + "total_bytes":17179869184, + "free_bytes":31711232, + "used_bytes":17148157952 + }, + "uptime_ms":2187246000 + }, + "response_times":{ + "max_ms":0 + }, + "requests":{ + "total":0, + "disconnects":0, + "status_codes":{ + + } + }, + "concurrent_connections":3, + "usage":{ + "kibana":{ + "index":".kibana", + "dashboard":{ + "total":0 + }, + "visualization":{ + "total":0 + }, + "search":{ + "total":0 + }, + "index_pattern":{ + "total":0 + }, + "graph_workspace":{ + "total":0 + }, + "timelion_sheet":{ + "total":0 + } + }, + "reporting":{ + "available":true, + "enabled":true, + "browser_type":"phantom", + "all":0, + "csv":{ + "available":true, + "total":0 + }, + "printable_pdf":{ + "available":true, + "total":0, + "app":{ + "visualization":0, + "dashboard":0 + }, + "layout":{ + "print":0, + "preserve_layout":0 + } + }, + "status":{ + + }, + "last_day":{ + "all":0, + "csv":{ + "available":true, + "total":0 + }, + "printable_pdf":{ + "available":true, + "total":0, + "app":{ + "visualization":0, + "dashboard":0 + }, + "layout":{ + "print":0, + "preserve_layout":0 + } + }, + "status":{ + + } + }, + "last_7_days":{ + "all":0, + "csv":{ + "available":true, + "total":0 + }, + "printable_pdf":{ + "available":true, + "total":0, + "app":{ + "visualization":0, + "dashboard":0 + }, + "layout":{ + "print":0, + "preserve_layout":0 + } + }, + "status":{ + + } + } } }, - "mem": { - "free_in_bytes": 896122880, - "total_in_bytes": 17179869184 - } + "cluster_uuid":"NkfU5AinRnyFnqBD36zhEw" } -} diff --git a/metricbeat/module/kibana/stats/data.go b/metricbeat/module/kibana/stats/data.go index 126b01c3f2b9..1802cfcb6310 100644 --- a/metricbeat/module/kibana/stats/data.go +++ b/metricbeat/module/kibana/stats/data.go @@ -24,66 +24,59 @@ import ( s "github.com/elastic/beats/libbeat/common/schema" c "github.com/elastic/beats/libbeat/common/schema/mapstriface" "github.com/elastic/beats/metricbeat/mb" + "github.com/elastic/beats/metricbeat/module/kibana" ) var ( schema = s.Schema{ - "cluster_uuid": c.Str("cluster_uuid"), - "name": c.Str("name"), - "uuid": c.Str("uuid"), - "version": c.Dict("version", s.Schema{ - "number": c.Str("number"), - }), - "status": c.Dict("status", s.Schema{ - "overall": c.Dict("overall", s.Schema{ - "state": c.Str("state"), - }), - }), - "response_times": c.Dict("response_times", s.Schema{ - "avg": s.Object{ - "ms": c.Float("avg_in_millis"), - }, - "max": s.Object{ - "ms": c.Int("max_in_millis"), - }, - }), - "requests": c.Dict("requests", s.Schema{ - "total": c.Int("total", s.Optional), - "disconnects": c.Int("disconnects", s.Optional), - }), + "uuid": c.Str("kibana.uuid"), + "name": c.Str("kibana.name"), + "index": c.Str("kibana.name"), + "host": s.Object{ + "name": c.Str("kibana.host"), + }, + "transport_address": c.Str("kibana.transport_address"), + "version": c.Str("kibana.version"), + "snapshot": c.Bool("kibana.snapshot"), + "status": c.Str("kibana.status"), "concurrent_connections": c.Int("concurrent_connections"), - "sockets": c.Dict("sockets", s.Schema{ - "http": c.Dict("http", s.Schema{ - "total": c.Int("total"), - }), - "https": c.Dict("https", s.Schema{ - "total": c.Int("total"), - }), - }), - "event_loop_delay": c.Float("event_loop_delay"), "process": c.Dict("process", s.Schema{ - "memory": c.Dict("mem", s.Schema{ - "heap": s.Object{ - "max": s.Object{ - "bytes": c.Int("heap_max_in_bytes"), + "event_loop_delay": s.Object{ + "ms": c.Float("event_loop_delay"), + }, + "memory": c.Dict("memory", s.Schema{ + "heap": c.Dict("heap", s.Schema{ + "total": s.Object{ + "bytes": c.Int("total_bytes"), }, "used": s.Object{ - "bytes": c.Int("heap_used_in_bytes"), + "bytes": c.Int("used_bytes"), + }, + "size_limit": s.Object{ + "bytes": c.Int("size_limit"), }, - }, - "resident_set_size": s.Object{ - "bytes": c.Int("resident_set_size_in_bytes"), - }, - "external": s.Object{ - "bytes": c.Int("external_in_bytes"), - }, + }), }), - "pid": c.Int("pid"), "uptime": s.Object{ "ms": c.Int("uptime_ms"), }, }), + "request": RequestsDict, + "response_time": c.Dict("response_times", s.Schema{ + "avg": s.Object{ + "ms": c.Int("avg_ms", s.Optional), + }, + "max": s.Object{ + "ms": c.Int("max_ms", s.Optional), + }, + }), } + + // RequestsDict defines how to convert the requests field + RequestsDict = c.Dict("requests", s.Schema{ + "disconnects": c.Int("disconnects", s.Optional), + "total": c.Int("total", s.Optional), + }) ) func eventMapping(r mb.ReporterV2, content []byte) error { @@ -104,10 +97,22 @@ func eventMapping(r mb.ReporterV2, content []byte) error { event.RootFields.Put("service.name", "kibana") // Set elasticsearch cluster id - if clusterID, ok := dataFields["cluster_uuid"]; ok { - delete(dataFields, "cluster_uuid") - event.RootFields.Put("elasticsearch.cluster.id", clusterID) + elasticsearchClusterID, ok := data["cluster_uuid"] + if !ok { + return kibana.ReportErrorForMissingField("cluster_uuid", r) + } + event.RootFields.Put("elasticsearch.cluster.id", elasticsearchClusterID) + + // Set process PID + process, ok := data["process"].(map[string]interface{}) + if !ok { + return kibana.ReportErrorForMissingField("process", r) + } + pid, ok := process["pid"].(float64) + if !ok { + return kibana.ReportErrorForMissingField("process.pid", r) } + event.RootFields.Put("process.pid", int(pid)) event.MetricSetFields = dataFields diff --git a/metricbeat/module/kibana/stats/data_test.go b/metricbeat/module/kibana/stats/data_test.go index ca01331137c3..19daa5562521 100644 --- a/metricbeat/module/kibana/stats/data_test.go +++ b/metricbeat/module/kibana/stats/data_test.go @@ -29,7 +29,7 @@ import ( "github.com/stretchr/testify/assert" ) -func TestStats(t *testing.T) { +func TestEventMapping(t *testing.T) { files, err := filepath.Glob("./_meta/test/stats.*.json") assert.NoError(t, err) diff --git a/metricbeat/module/kibana/stats/data_xpack.go b/metricbeat/module/kibana/stats/data_xpack.go new file mode 100644 index 000000000000..d874091dad6c --- /dev/null +++ b/metricbeat/module/kibana/stats/data_xpack.go @@ -0,0 +1,188 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package stats + +import ( + "encoding/json" + "time" + + "github.com/elastic/beats/libbeat/common" + s "github.com/elastic/beats/libbeat/common/schema" + c "github.com/elastic/beats/libbeat/common/schema/mapstriface" + "github.com/elastic/beats/metricbeat/helper/xpack" + "github.com/elastic/beats/metricbeat/mb" + "github.com/elastic/beats/metricbeat/module/kibana" +) + +var ( + schemaXPackMonitoring = s.Schema{ + "concurrent_connections": c.Int("concurrent_connections"), + "os": c.Dict("os", s.Schema{ + "load": c.Dict("load", s.Schema{ + "1m": c.Float("1m"), + "5m": c.Float("5m"), + "15m": c.Float("15m"), + }), + "memory": c.Dict("memory", s.Schema{ + "total_in_bytes": c.Int("total_bytes"), + "free_in_bytes": c.Int("free_bytes"), + "used_in_bytes": c.Int("used_bytes"), + }), + "uptime_in_millis": c.Int("uptime_ms"), + }), + "process": c.Dict("process", s.Schema{ + "event_loop_delay": c.Float("event_loop_delay"), + "memory": c.Dict("memory", s.Schema{ + "heap": c.Dict("heap", s.Schema{ + "total_in_bytes": c.Int("total_bytes"), + "used_in_bytes": c.Int("used_bytes"), + "size_limit": c.Int("size_limit"), + }), + }), + "uptime_in_millis": c.Int("uptime_ms"), + }), + "requests": RequestsDict, + "response_times": c.Dict("response_times", s.Schema{ + "average": c.Int("avg_ms", s.Optional), + "max": c.Int("max_ms", s.Optional), + }, c.DictOptional), + "kibana": c.Dict("kibana", s.Schema{ + "uuid": c.Str("uuid"), + "name": c.Str("name"), + "index": c.Str("index"), + "host": c.Str("host"), + "transport_address": c.Str("transport_address"), + "version": c.Str("version"), + "snapshot": c.Bool("snapshot"), + "status": c.Str("status"), + }), + "usage": c.Dict("usage", s.Schema{ + "index": c.Str("kibana.index"), + "index_pattern": c.Dict("kibana.index_pattern", s.Schema{ + "total": c.Int("total"), + }), + "search": c.Dict("kibana.search", s.Schema{ + "total": c.Int("total"), + }), + "visualization": c.Dict("kibana.visualization", s.Schema{ + "total": c.Int("total"), + }), + "dashboard": c.Dict("kibana.dashboard", s.Schema{ + "total": c.Int("total"), + }), + "timelion_sheet": c.Dict("kibana.timelion_sheet", s.Schema{ + "total": c.Int("total"), + }), + "graph_workspace": c.Dict("kibana.graph_workspace", s.Schema{ + "total": c.Int("total"), + }), + "xpack": s.Object{ + "reporting": c.Dict("reporting", s.Schema{ + "available": c.Bool("available"), + "enabled": c.Bool("enabled"), + "browser_type": c.Str("browser_type"), + "_all": c.Int("all"), + "csv": reportingCsvDict, + "printable_pdf": reportingPrintablePdfDict, + "status": reportingStatusDict, + "lastDay": c.Dict("last_day", reportingPeriodSchema, c.DictOptional), + "last7Days": c.Dict("last_7_days", reportingPeriodSchema, c.DictOptional), + }, c.DictOptional), + }, + }), + } + + reportingCsvDict = c.Dict("csv", s.Schema{ + "available": c.Bool("available"), + "total": c.Int("total"), + }, c.DictOptional) + + reportingPrintablePdfDict = c.Dict("printable_pdf", s.Schema{ + "available": c.Bool("available"), + "total": c.Int("total"), + "app": c.Dict("app", s.Schema{ + "visualization": c.Int("visualization"), + "dashboard": c.Int("dashboard"), + }, c.DictOptional), + "layout": c.Dict("layout", s.Schema{ + "print": c.Int("print"), + "preserve_layout": c.Int("preserve_layout"), + }, c.DictOptional), + }, c.DictOptional) + + reportingStatusDict = c.Dict("status", s.Schema{ + "completed": c.Int("completed", s.Optional), + "failed": c.Int("failed", s.Optional), + "processing": c.Int("processing", s.Optional), + "pending": c.Int("pending", s.Optional), + }, c.DictOptional) + + reportingPeriodSchema = s.Schema{ + "_all": c.Int("all"), + "csv": reportingCsvDict, + "printable_pdf": reportingPrintablePdfDict, + "status": reportingStatusDict, + } +) + +func eventMappingXPack(r mb.ReporterV2, intervalMs int64, content []byte) error { + var data map[string]interface{} + err := json.Unmarshal(content, &data) + if err != nil { + r.Error(err) + return err + } + + kibanaStatsFields, err := schemaXPackMonitoring.Apply(data) + if err != nil { + r.Error(err) + return err + } + + process, ok := data["process"].(map[string]interface{}) + if !ok { + return kibana.ReportErrorForMissingField("process", r) + } + memory, ok := process["memory"].(map[string]interface{}) + if !ok { + return kibana.ReportErrorForMissingField("process.memory", r) + } + + rss, ok := memory["resident_set_size_bytes"].(float64) + if !ok { + return kibana.ReportErrorForMissingField("process.memory.resident_set_size_bytes", r) + } + kibanaStatsFields.Put("process.memory.resident_set_size_in_bytes", int64(rss)) + + timestamp := time.Now() + kibanaStatsFields.Put("timestamp", timestamp) + + var event mb.Event + event.RootFields = common.MapStr{ + "cluster_uuid": data["cluster_uuid"].(string), + "timestamp": timestamp, + "interval_ms": intervalMs, + "type": "kibana_stats", + "kibana_stats": kibanaStatsFields, + } + + event.Index = xpack.MakeMonitoringIndexName(xpack.Kibana) + r.Event(event) + + return nil +} diff --git a/metricbeat/module/kibana/stats/data_xpack_test.go b/metricbeat/module/kibana/stats/data_xpack_test.go new file mode 100644 index 000000000000..d2d2a042b585 --- /dev/null +++ b/metricbeat/module/kibana/stats/data_xpack_test.go @@ -0,0 +1,47 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +// +build !integration + +package stats + +import ( + "io/ioutil" + "path/filepath" + "testing" + + mbtest "github.com/elastic/beats/metricbeat/mb/testing" + + "github.com/stretchr/testify/assert" +) + +func TestEventMappingXPack(t *testing.T) { + + files, err := filepath.Glob("./_meta/test/stats.*.json") + assert.NoError(t, err) + + for _, f := range files { + input, err := ioutil.ReadFile(f) + assert.NoError(t, err) + + reporter := &mbtest.CapturingReporterV2{} + err = eventMappingXPack(reporter, 10000, input) + assert.NoError(t, err, f) + assert.True(t, len(reporter.GetEvents()) >= 1, f) + assert.Equal(t, 0, len(reporter.GetErrors()), f) + } +} diff --git a/metricbeat/module/kibana/stats/stats.go b/metricbeat/module/kibana/stats/stats.go index 67dd0f5b417c..c2dcace05062 100644 --- a/metricbeat/module/kibana/stats/stats.go +++ b/metricbeat/module/kibana/stats/stats.go @@ -22,6 +22,7 @@ import ( "github.com/elastic/beats/metricbeat/helper" "github.com/elastic/beats/metricbeat/mb" "github.com/elastic/beats/metricbeat/mb/parse" + "github.com/elastic/beats/metricbeat/module/kibana" ) // init registers the MetricSet with the central registry. @@ -34,30 +35,42 @@ func init() { var ( hostParser = parse.URLHostParserBuilder{ - DefaultScheme: "http", - PathConfigKey: "path", - DefaultPath: "api/stats", - QueryParams: "extended=true", // make Kibana fetch the cluster_uuid + DefaultScheme: "http", + BasePathConfigKey: "basepath", + DefaultPath: "api/stats", + QueryParams: "extended=true", // make Kibana fetch the cluster_uuid }.Build() ) // MetricSet type defines all fields of the MetricSet type MetricSet struct { mb.BaseMetricSet - http *helper.HTTP + http *helper.HTTP + xPackEnabled bool } // New create a new instance of the MetricSet func New(base mb.BaseMetricSet) (mb.MetricSet, error) { cfgwarn.Experimental("The kibana stats metricset is experimental") + config := kibana.DefaultConfig() + if err := base.Module().UnpackConfig(&config); err != nil { + return nil, err + } + + if config.XPackEnabled { + cfgwarn.Experimental("The experimental xpack.enabled flag in kibana/stats metricset is enabled.") + } + http, err := helper.NewHTTP(base) if err != nil { return nil, err } + return &MetricSet{ base, http, + config.XPackEnabled, }, nil } @@ -71,5 +84,11 @@ func (m *MetricSet) Fetch(r mb.ReporterV2) { return } - eventMapping(r, content) + if m.xPackEnabled { + intervalMs := m.Module().Config().Period.Nanoseconds() / 1000 / 1000 + eventMappingXPack(r, intervalMs, content) + } else { + eventMapping(r, content) + } + } diff --git a/metricbeat/modules.d/kibana.yml.disabled b/metricbeat/modules.d/kibana.yml.disabled index a2476f1b37a5..78f769cd65e1 100644 --- a/metricbeat/modules.d/kibana.yml.disabled +++ b/metricbeat/modules.d/kibana.yml.disabled @@ -6,5 +6,6 @@ # - status period: 10s hosts: ["localhost:5601"] + #basepath: "" #username: "user" #password: "secret" From a314e34ea823c39f0838be59de7f299831a8a018 Mon Sep 17 00:00:00 2001 From: Vijay Samuel Date: Fri, 20 Jul 2018 02:04:15 -0700 Subject: [PATCH 11/34] Add kubernetes specs for auditbeat file integrity monitoring (#7642) --- CHANGELOG.asciidoc | 1 + deploy/kubernetes/Makefile | 2 +- deploy/kubernetes/auditbeat-kubernetes.yaml | 185 ++++++++++++++++++ deploy/kubernetes/auditbeat/README.md | 31 +++ .../auditbeat-daemonset-configmap.yaml | 52 +++++ .../auditbeat/auditbeat-daemonset.yaml | 96 +++++++++ .../auditbeat/auditbeat-role-binding.yaml | 12 ++ .../kubernetes/auditbeat/auditbeat-role.yaml | 13 ++ .../auditbeat/auditbeat-service-account.yaml | 7 + 9 files changed, 398 insertions(+), 1 deletion(-) create mode 100644 deploy/kubernetes/auditbeat-kubernetes.yaml create mode 100644 deploy/kubernetes/auditbeat/README.md create mode 100644 deploy/kubernetes/auditbeat/auditbeat-daemonset-configmap.yaml create mode 100644 deploy/kubernetes/auditbeat/auditbeat-daemonset.yaml create mode 100644 deploy/kubernetes/auditbeat/auditbeat-role-binding.yaml create mode 100644 deploy/kubernetes/auditbeat/auditbeat-role.yaml create mode 100644 deploy/kubernetes/auditbeat/auditbeat-service-account.yaml diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index 519737a6ee74..e144421ab1d6 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -190,6 +190,7 @@ https://github.com/elastic/beats/compare/v6.2.3...master[Check the HEAD diff] Linux kernel not supporting auditing (CONFIG_AUDIT=n). {pull}7012[7012] - Added XXH64 hash option for file integrity checks. {pull}7311[7311] - Added the `show auditd-rules` and `show auditd-status` commands to show kernel rules and status. {pull}7114[7114] +- Add kubernetes specs for auditbeat file integrity monitoring {pull}7642[7642] *Filebeat* diff --git a/deploy/kubernetes/Makefile b/deploy/kubernetes/Makefile index 10732ea45758..722cac158d1d 100644 --- a/deploy/kubernetes/Makefile +++ b/deploy/kubernetes/Makefile @@ -1,4 +1,4 @@ -ALL=filebeat metricbeat +ALL=filebeat metricbeat auditbeat BEAT_VERSION=$(shell head -n 1 ../../libbeat/docs/version.asciidoc | cut -c 17- ) .PHONY: all $(ALL) diff --git a/deploy/kubernetes/auditbeat-kubernetes.yaml b/deploy/kubernetes/auditbeat-kubernetes.yaml new file mode 100644 index 000000000000..90a7ae4a675f --- /dev/null +++ b/deploy/kubernetes/auditbeat-kubernetes.yaml @@ -0,0 +1,185 @@ +--- +apiVersion: v1 +kind: ConfigMap +metadata: + name: auditbeat-config + namespace: kube-system + labels: + k8s-app: auditbeat +data: + auditbeat.yml: |- + auditbeat.config.modules: + # Mounted `auditbeat-daemonset-modules` configmap: + path: ${path.config}/modules.d/*.yml + # Reload module configs as they change: + reload.enabled: false + + processors: + - add_cloud_metadata: + + cloud.id: ${ELASTIC_CLOUD_ID} + cloud.auth: ${ELASTIC_CLOUD_AUTH} + + output.elasticsearch: + hosts: ['${ELASTICSEARCH_HOST:elasticsearch}:${ELASTICSEARCH_PORT:9200}'] + username: ${ELASTICSEARCH_USERNAME} + password: ${ELASTICSEARCH_PASSWORD} +--- +apiVersion: v1 +kind: ConfigMap +metadata: + name: auditbeat-daemonset-modules + namespace: kube-system + labels: + k8s-app: auditbeat +data: + system.yml: |- + - module: file_integrity + paths: + - /hostfs/bin + - /hostfs/usr/bin + - /hostfs/sbin + - /hostfs/usr/sbin + - /hostfs/etc + exclude_files: + - '(?i)\.sw[nop]$' + - '~$' + - '/\.git($|/)' + scan_at_start: true + scan_rate_per_sec: 50 MiB + max_file_size: 100 MiB + hash_types: [sha1] + recursive: true +--- +# Deploy a auditbeat instance per node for node metrics retrieval +apiVersion: extensions/v1beta1 +kind: DaemonSet +metadata: + name: auditbeat + namespace: kube-system + labels: + k8s-app: auditbeat +spec: + template: + metadata: + labels: + k8s-app: auditbeat + spec: + serviceAccountName: auditbeat + terminationGracePeriodSeconds: 30 + hostNetwork: true + dnsPolicy: ClusterFirstWithHostNet + containers: + - name: auditbeat + image: docker.elastic.co/beats/auditbeat:7.0.0-alpha1 + args: [ + "-c", "/etc/auditbeat.yml" + ] + env: + - name: ELASTICSEARCH_HOST + value: elasticsearch + - name: ELASTICSEARCH_PORT + value: "9200" + - name: ELASTICSEARCH_USERNAME + value: elastic + - name: ELASTICSEARCH_PASSWORD + value: changeme + - name: ELASTIC_CLOUD_ID + value: + - name: ELASTIC_CLOUD_AUTH + value: + securityContext: + runAsUser: 0 + resources: + limits: + memory: 200Mi + requests: + cpu: 100m + memory: 100Mi + volumeMounts: + - name: config + mountPath: /etc/auditbeat.yml + readOnly: true + subPath: auditbeat.yml + - name: modules + mountPath: /usr/share/auditbeat/modules.d + readOnly: true + - name: bin + mountPath: /hostfs/bin + readOnly: true + - name: sbin + mountPath: /hostfs/sbin + readOnly: true + - name: usrbin + mountPath: /hostfs/usr/bin + readOnly: true + - name: usrsbin + mountPath: /hostfs/usr/sbin + readOnly: true + - name: etc + mountPath: /hostfs/etc + readOnly: true + volumes: + - name: bin + hostPath: + path: /bin + - name: usrbin + hostPath: + path: /usr/bin + - name: sbin + hostPath: + path: /sbin + - name: usrsbin + hostPath: + path: /usr/sbin + - name: etc + hostPath: + path: /etc + - name: config + configMap: + defaultMode: 0600 + name: auditbeat-config + - name: modules + configMap: + defaultMode: 0600 + name: auditbeat-daemonset-modules + - name: data + hostPath: + path: /var/lib/auditbeat-data + type: DirectoryOrCreate +--- +apiVersion: rbac.authorization.k8s.io/v1beta1 +kind: ClusterRoleBinding +metadata: + name: auditbeat +subjects: +- kind: ServiceAccount + name: auditbeat + namespace: kube-system +roleRef: + kind: ClusterRole + name: auditbeat + apiGroup: rbac.authorization.k8s.io +--- +apiVersion: rbac.authorization.k8s.io/v1beta1 +kind: ClusterRole +metadata: + name: auditbeat + labels: + k8s-app: auditbeat +rules: +- apiGroups: [""] + resources: + - nodes + - namespaces + - pods + verbs: ["get", "list", "watch"] +--- +apiVersion: v1 +kind: ServiceAccount +metadata: + name: auditbeat + namespace: kube-system + labels: + k8s-app: auditbeat +--- diff --git a/deploy/kubernetes/auditbeat/README.md b/deploy/kubernetes/auditbeat/README.md new file mode 100644 index 000000000000..a0bc0316f49f --- /dev/null +++ b/deploy/kubernetes/auditbeat/README.md @@ -0,0 +1,31 @@ +# Auditbeat + +## Ship audit information from Kubernetes to Elasticsearch + +### Kubernetes DaemonSet + +By deploying auditbeat as a [DaemonSet](https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/) +we ensure we get a running auditbeat daemon on each node of the cluster. + +Everything is deployed under `kube-system` namespace, you can change that by +updating YAML manifests under this folder. + +### Settings + +We use official [Beats Docker images](https://github.com/elastic/beats-docker), +as they allow external files configuration, a [ConfigMap](https://kubernetes.io/docs/tasks/configure-pod-container/configure-pod-configmap/) +is used for kubernetes specific settings. Check [auditbeat-configmap.yaml](auditbeat-configmap.yaml) +for details. + +Also, [auditbeat-daemonset.yaml](auditbeat-daemonset.yaml) uses a set of environment +variables to configure Elasticsearch output: + +Variable | Default | Description +-------- | ------- | ----------- +ELASTICSEARCH_HOST | elasticsearch | Elasticsearch host +ELASTICSEARCH_PORT | 9200 | Elasticsearch port +ELASTICSEARCH_USERNAME | elastic | Elasticsearch username for HTTP auth +ELASTICSEARCH_PASSWORD | changeme | Elasticsearch password + +If there is an existing `elasticsearch` service in the kubernetes cluster these +defaults will use it. diff --git a/deploy/kubernetes/auditbeat/auditbeat-daemonset-configmap.yaml b/deploy/kubernetes/auditbeat/auditbeat-daemonset-configmap.yaml new file mode 100644 index 000000000000..d5589df00bf8 --- /dev/null +++ b/deploy/kubernetes/auditbeat/auditbeat-daemonset-configmap.yaml @@ -0,0 +1,52 @@ +--- +apiVersion: v1 +kind: ConfigMap +metadata: + name: auditbeat-config + namespace: kube-system + labels: + k8s-app: auditbeat +data: + auditbeat.yml: |- + auditbeat.config.modules: + # Mounted `auditbeat-daemonset-modules` configmap: + path: ${path.config}/modules.d/*.yml + # Reload module configs as they change: + reload.enabled: false + + processors: + - add_cloud_metadata: + + cloud.id: ${ELASTIC_CLOUD_ID} + cloud.auth: ${ELASTIC_CLOUD_AUTH} + + output.elasticsearch: + hosts: ['${ELASTICSEARCH_HOST:elasticsearch}:${ELASTICSEARCH_PORT:9200}'] + username: ${ELASTICSEARCH_USERNAME} + password: ${ELASTICSEARCH_PASSWORD} +--- +apiVersion: v1 +kind: ConfigMap +metadata: + name: auditbeat-daemonset-modules + namespace: kube-system + labels: + k8s-app: auditbeat +data: + system.yml: |- + - module: file_integrity + paths: + - /hostfs/bin + - /hostfs/usr/bin + - /hostfs/sbin + - /hostfs/usr/sbin + - /hostfs/etc + exclude_files: + - '(?i)\.sw[nop]$' + - '~$' + - '/\.git($|/)' + scan_at_start: true + scan_rate_per_sec: 50 MiB + max_file_size: 100 MiB + hash_types: [sha1] + recursive: true diff --git a/deploy/kubernetes/auditbeat/auditbeat-daemonset.yaml b/deploy/kubernetes/auditbeat/auditbeat-daemonset.yaml new file mode 100644 index 000000000000..2a3f19aac69f --- /dev/null +++ b/deploy/kubernetes/auditbeat/auditbeat-daemonset.yaml @@ -0,0 +1,96 @@ +# Deploy a auditbeat instance per node for node metrics retrieval +apiVersion: extensions/v1beta1 +kind: DaemonSet +metadata: + name: auditbeat + namespace: kube-system + labels: + k8s-app: auditbeat +spec: + template: + metadata: + labels: + k8s-app: auditbeat + spec: + serviceAccountName: auditbeat + terminationGracePeriodSeconds: 30 + hostNetwork: true + dnsPolicy: ClusterFirstWithHostNet + containers: + - name: auditbeat + image: docker.elastic.co/beats/auditbeat:%VERSION% + args: [ + "-c", "/etc/auditbeat.yml" + ] + env: + - name: ELASTICSEARCH_HOST + value: elasticsearch + - name: ELASTICSEARCH_PORT + value: "9200" + - name: ELASTICSEARCH_USERNAME + value: elastic + - name: ELASTICSEARCH_PASSWORD + value: changeme + - name: ELASTIC_CLOUD_ID + value: + - name: ELASTIC_CLOUD_AUTH + value: + securityContext: + runAsUser: 0 + resources: + limits: + memory: 200Mi + requests: + cpu: 100m + memory: 100Mi + volumeMounts: + - name: config + mountPath: /etc/auditbeat.yml + readOnly: true + subPath: auditbeat.yml + - name: modules + mountPath: /usr/share/auditbeat/modules.d + readOnly: true + - name: bin + mountPath: /hostfs/bin + readOnly: true + - name: sbin + mountPath: /hostfs/sbin + readOnly: true + - name: usrbin + mountPath: /hostfs/usr/bin + readOnly: true + - name: usrsbin + mountPath: /hostfs/usr/sbin + readOnly: true + - name: etc + mountPath: /hostfs/etc + readOnly: true + volumes: + - name: bin + hostPath: + path: /bin + - name: usrbin + hostPath: + path: /usr/bin + - name: sbin + hostPath: + path: /sbin + - name: usrsbin + hostPath: + path: /usr/sbin + - name: etc + hostPath: + path: /etc + - name: config + configMap: + defaultMode: 0600 + name: auditbeat-config + - name: modules + configMap: + defaultMode: 0600 + name: auditbeat-daemonset-modules + - name: data + hostPath: + path: /var/lib/auditbeat-data + type: DirectoryOrCreate diff --git a/deploy/kubernetes/auditbeat/auditbeat-role-binding.yaml b/deploy/kubernetes/auditbeat/auditbeat-role-binding.yaml new file mode 100644 index 000000000000..dec98a5f1e58 --- /dev/null +++ b/deploy/kubernetes/auditbeat/auditbeat-role-binding.yaml @@ -0,0 +1,12 @@ +apiVersion: rbac.authorization.k8s.io/v1beta1 +kind: ClusterRoleBinding +metadata: + name: auditbeat +subjects: +- kind: ServiceAccount + name: auditbeat + namespace: kube-system +roleRef: + kind: ClusterRole + name: auditbeat + apiGroup: rbac.authorization.k8s.io diff --git a/deploy/kubernetes/auditbeat/auditbeat-role.yaml b/deploy/kubernetes/auditbeat/auditbeat-role.yaml new file mode 100644 index 000000000000..ae6d32f4149b --- /dev/null +++ b/deploy/kubernetes/auditbeat/auditbeat-role.yaml @@ -0,0 +1,13 @@ +apiVersion: rbac.authorization.k8s.io/v1beta1 +kind: ClusterRole +metadata: + name: auditbeat + labels: + k8s-app: auditbeat +rules: +- apiGroups: [""] + resources: + - nodes + - namespaces + - pods + verbs: ["get", "list", "watch"] diff --git a/deploy/kubernetes/auditbeat/auditbeat-service-account.yaml b/deploy/kubernetes/auditbeat/auditbeat-service-account.yaml new file mode 100644 index 000000000000..641f4ddd1eba --- /dev/null +++ b/deploy/kubernetes/auditbeat/auditbeat-service-account.yaml @@ -0,0 +1,7 @@ +apiVersion: v1 +kind: ServiceAccount +metadata: + name: auditbeat + namespace: kube-system + labels: + k8s-app: auditbeat From b8b8c5938dd64bf43e399398f5f6f31452f1a0e6 Mon Sep 17 00:00:00 2001 From: ruflin Date: Fri, 20 Jul 2018 13:50:40 +0200 Subject: [PATCH 12/34] Release the rename processor as GA --- CHANGELOG.asciidoc | 1 + libbeat/processors/actions/rename.go | 3 --- 2 files changed, 1 insertion(+), 3 deletions(-) diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index 519737a6ee74..fe252bb77a24 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -181,6 +181,7 @@ https://github.com/elastic/beats/compare/v6.2.3...master[Check the HEAD diff] - Refactor error handing in schema.Apply(). {pull}7335[7335] - Add additional types to kubernetes metadata {pull}7457[7457] - Add module state reporting for X-Pack Monitoring. {pull}7075[7075] +- Release the rename processor as GA. {pull}7656[7656] *Auditbeat* diff --git a/libbeat/processors/actions/rename.go b/libbeat/processors/actions/rename.go index 47e367b9b5f3..bd39f93ab74d 100644 --- a/libbeat/processors/actions/rename.go +++ b/libbeat/processors/actions/rename.go @@ -24,7 +24,6 @@ import ( "github.com/elastic/beats/libbeat/beat" "github.com/elastic/beats/libbeat/common" - "github.com/elastic/beats/libbeat/common/cfgwarn" "github.com/elastic/beats/libbeat/logp" "github.com/elastic/beats/libbeat/processors" ) @@ -51,8 +50,6 @@ func init() { } func newRenameFields(c *common.Config) (processors.Processor, error) { - - cfgwarn.Beta("Beta rename processor is used.") config := renameFieldsConfig{ IgnoreMissing: false, FailOnError: true, From 2a8dbe0fd1873611eaef1ac52ea01a8784f74e20 Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Fri, 20 Jul 2018 15:58:20 +0200 Subject: [PATCH 13/34] Fix log message for Kibana beta state (#7631) From copy paste Kafka was in the log message instead of Kibana. --- metricbeat/module/kibana/status/status.go | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/metricbeat/module/kibana/status/status.go b/metricbeat/module/kibana/status/status.go index ea5f9cc3ec53..1b559ea3d177 100644 --- a/metricbeat/module/kibana/status/status.go +++ b/metricbeat/module/kibana/status/status.go @@ -50,7 +50,7 @@ type MetricSet struct { // New create a new instance of the MetricSet func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Beta("The kafka partition metricset is beta") + cfgwarn.Beta("The Kibana status metricset is beta") http, err := helper.NewHTTP(base) if err != nil { From e80283b1272971bcb362a0eb0f42d7b8c02ca255 Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Fri, 20 Jul 2018 16:03:00 +0200 Subject: [PATCH 14/34] Clean up experimental and beta messages (#7659) Sometimes the old logging mechanism was used. If all use the new one it is easier to find all the entries. In addition some messages were inconsistent. --- heartbeat/beater/heartbeat.go | 3 ++- libbeat/plugin/cli.go | 3 ++- metricbeat/module/ceph/osd_df/osd_df.go | 2 +- 3 files changed, 5 insertions(+), 3 deletions(-) diff --git a/heartbeat/beater/heartbeat.go b/heartbeat/beater/heartbeat.go index f449bf5262ac..036f48db5983 100644 --- a/heartbeat/beater/heartbeat.go +++ b/heartbeat/beater/heartbeat.go @@ -28,6 +28,7 @@ import ( "github.com/elastic/beats/heartbeat/config" "github.com/elastic/beats/heartbeat/monitors" "github.com/elastic/beats/heartbeat/scheduler" + "github.com/elastic/beats/libbeat/common/cfgwarn" ) type Heartbeat struct { @@ -38,7 +39,7 @@ type Heartbeat struct { } func New(b *beat.Beat, cfg *common.Config) (beat.Beater, error) { - logp.Warn("Beta: Heartbeat is beta software") + cfgwarn.Beta("Heartbeat is beta software") config := config.DefaultConfig if err := cfg.Unpack(&config); err != nil { diff --git a/libbeat/plugin/cli.go b/libbeat/plugin/cli.go index 40a356211ad4..6171bef7e6bd 100644 --- a/libbeat/plugin/cli.go +++ b/libbeat/plugin/cli.go @@ -24,6 +24,7 @@ import ( "flag" "strings" + "github.com/elastic/beats/libbeat/common/cfgwarn" "github.com/elastic/beats/libbeat/logp" ) @@ -54,7 +55,7 @@ func init() { func Initialize() error { if len(plugins.paths) > 0 { - logp.Warn("EXPERIMENTAL: loadable plugin support is experimental") + cfgwarn.Experimental("loadable plugin support is experimental") } for _, path := range plugins.paths { diff --git a/metricbeat/module/ceph/osd_df/osd_df.go b/metricbeat/module/ceph/osd_df/osd_df.go index 40764c9d1444..9f754e6d8b5a 100644 --- a/metricbeat/module/ceph/osd_df/osd_df.go +++ b/metricbeat/module/ceph/osd_df/osd_df.go @@ -50,7 +50,7 @@ type MetricSet struct { } func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Beta("The ceph osd_df metricset is experimental") + cfgwarn.Experimental("The ceph osd_df metricset is experimental") http, err := helper.NewHTTP(base) if err != nil { From bf6924dc43cfe9c6f5805f9f64e1f10cd800848b Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Fri, 20 Jul 2018 17:41:43 +0200 Subject: [PATCH 15/34] Release raid and socket metricset from system module as GA (#7658) * Release raid and socket metricset from system module as GA * remove raid metricset title --- CHANGELOG.asciidoc | 1 + metricbeat/docs/modules/system/raid.asciidoc | 2 -- metricbeat/docs/modules/system/socket.asciidoc | 2 -- metricbeat/docs/modules_list.asciidoc | 4 ++-- metricbeat/module/system/fields.go | 2 +- metricbeat/module/system/raid/_meta/docs.asciidoc | 4 ++-- metricbeat/module/system/raid/_meta/fields.yml | 2 +- metricbeat/module/system/raid/raid.go | 3 --- metricbeat/module/system/socket/_meta/fields.yml | 2 +- metricbeat/module/system/socket/socket.go | 3 --- 10 files changed, 8 insertions(+), 17 deletions(-) diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index 06eb08cfb729..cebb87ce771f 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -311,6 +311,7 @@ https://github.com/elastic/beats/compare/v6.2.3...master[Check the HEAD diff] - Add support for bearer token files to HTTP helper. {pull}7527[7527] - Add Elasticsearch index recovery metricset. {pull}7225[7225] - Run Kafka integration tests on version 1.1.0 {pull}7616[7616] +- Release raid and socket metricset from system module as GA. {pull}7658[7658] *Packetbeat* diff --git a/metricbeat/docs/modules/system/raid.asciidoc b/metricbeat/docs/modules/system/raid.asciidoc index f172194edbd3..8a90a2fe31c1 100644 --- a/metricbeat/docs/modules/system/raid.asciidoc +++ b/metricbeat/docs/modules/system/raid.asciidoc @@ -5,8 +5,6 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-metricset-system-raid]] === System raid metricset -beta[] - include::../../../module/system/raid/_meta/docs.asciidoc[] diff --git a/metricbeat/docs/modules/system/socket.asciidoc b/metricbeat/docs/modules/system/socket.asciidoc index 9f399ac2f663..117c0532d9af 100644 --- a/metricbeat/docs/modules/system/socket.asciidoc +++ b/metricbeat/docs/modules/system/socket.asciidoc @@ -5,8 +5,6 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-metricset-system-socket]] === System socket metricset -beta[] - include::../../../module/system/socket/_meta/docs.asciidoc[] diff --git a/metricbeat/docs/modules_list.asciidoc b/metricbeat/docs/modules_list.asciidoc index 015bea036d56..809bab134b9d 100644 --- a/metricbeat/docs/modules_list.asciidoc +++ b/metricbeat/docs/modules_list.asciidoc @@ -124,8 +124,8 @@ This file is generated! See scripts/docs_collector.py |<> |<> |<> -|<> beta[] -|<> beta[] +|<> +|<> |<> |<> experimental[] |image:./images/icon-no.png[No prebuilt dashboards] | .1+| .1+| |<> experimental[] diff --git a/metricbeat/module/system/fields.go b/metricbeat/module/system/fields.go index e5d1849ae2c7..00c32a6d4dc4 100644 --- a/metricbeat/module/system/fields.go +++ b/metricbeat/module/system/fields.go @@ -31,5 +31,5 @@ func init() { // Asset returns asset data func Asset() string { - return "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" + return "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" } diff --git a/metricbeat/module/system/raid/_meta/docs.asciidoc b/metricbeat/module/system/raid/_meta/docs.asciidoc index 6544b9da5993..a589d3df29f5 100644 --- a/metricbeat/module/system/raid/_meta/docs.asciidoc +++ b/metricbeat/module/system/raid/_meta/docs.asciidoc @@ -1,3 +1,3 @@ -=== system raid MetricSet +This is the raid metricset of the module system. It collects stats about the raid. -This is the raid metricset of the module system. +The config option `raid.mount_point:` can be used to configure the raid mount point. diff --git a/metricbeat/module/system/raid/_meta/fields.yml b/metricbeat/module/system/raid/_meta/fields.yml index 3a06b22027d0..35c6e2421825 100644 --- a/metricbeat/module/system/raid/_meta/fields.yml +++ b/metricbeat/module/system/raid/_meta/fields.yml @@ -2,7 +2,7 @@ type: group description: > raid - release: beta + release: ga fields: - name: name type: keyword diff --git a/metricbeat/module/system/raid/raid.go b/metricbeat/module/system/raid/raid.go index e1050bddf406..16f1475eab97 100644 --- a/metricbeat/module/system/raid/raid.go +++ b/metricbeat/module/system/raid/raid.go @@ -24,7 +24,6 @@ import ( "github.com/prometheus/procfs" "github.com/elastic/beats/libbeat/common" - "github.com/elastic/beats/libbeat/common/cfgwarn" "github.com/elastic/beats/metricbeat/mb" "github.com/elastic/beats/metricbeat/mb/parse" "github.com/elastic/beats/metricbeat/module/system" @@ -44,8 +43,6 @@ type MetricSet struct { // New creates a new instance of the raid metricset. func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Beta("The system raid metricset is beta") - systemModule, ok := base.Module().(*system.Module) if !ok { return nil, errors.New("unexpected module type") diff --git a/metricbeat/module/system/socket/_meta/fields.yml b/metricbeat/module/system/socket/_meta/fields.yml index 0a34d09a53a4..a75af1a9159c 100644 --- a/metricbeat/module/system/socket/_meta/fields.yml +++ b/metricbeat/module/system/socket/_meta/fields.yml @@ -2,7 +2,7 @@ type: group description: > TCP sockets that are active. - release: beta + release: ga fields: - name: direction type: keyword diff --git a/metricbeat/module/system/socket/socket.go b/metricbeat/module/system/socket/socket.go index 524eb3783921..7c45df08b7a1 100644 --- a/metricbeat/module/system/socket/socket.go +++ b/metricbeat/module/system/socket/socket.go @@ -28,7 +28,6 @@ import ( "syscall" "github.com/elastic/beats/libbeat/common" - "github.com/elastic/beats/libbeat/common/cfgwarn" "github.com/elastic/beats/libbeat/logp" "github.com/elastic/beats/metricbeat/mb" "github.com/elastic/beats/metricbeat/mb/parse" @@ -63,8 +62,6 @@ type MetricSet struct { } func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Beta("The system collector metricset is beta") - c := defaultConfig if err := base.Module().UnpackConfig(&c); err != nil { return nil, err From 630398df255d2e1009dffaf443e7aa78324bd0b9 Mon Sep 17 00:00:00 2001 From: DeDe Morton Date: Fri, 20 Jul 2018 15:08:47 -0700 Subject: [PATCH 16/34] Update geoip config docs (#7640) --- packetbeat/docs/images/kibana-update-map.png | Bin 275823 -> 471980 bytes packetbeat/docs/packetbeat-geoip.asciidoc | 30 +++++++++---------- 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/packetbeat/docs/images/kibana-update-map.png b/packetbeat/docs/images/kibana-update-map.png index 7a7785f14eb29d81ae290a978a00a6ac7fc9cb41..1a71050ee3348570f0b1fd5fa37bf26eee2f23ac 100644 GIT binary patch literal 471980 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 literal 275823 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 TG9qUf00000NkvXXu0mjf+CN9h diff --git a/packetbeat/docs/packetbeat-geoip.asciidoc b/packetbeat/docs/packetbeat-geoip.asciidoc index 5c108ef86c22..2a83c8db5e3e 100644 --- a/packetbeat/docs/packetbeat-geoip.asciidoc +++ b/packetbeat/docs/packetbeat-geoip.asciidoc @@ -2,22 +2,18 @@ == Export GeoIP Information You can use Packetbeat along with the -{plugindoc}/ingest-geoip.html[ingest geoIP processor plugin] in Elasticsearch +{plugins}/ingest-geoip.html[ingest geoIP processor plugin] in Elasticsearch to export geographic location information about source IPs for incoming HTTP requests. Then you can use this info to visualize the location of your clients on a map in Kibana. -Prior to version 5.0, Packetbeat provided a `geoip` configuration option for -exporting geoIP information about the source IPs. Starting with 5.0, the -`geoip` configuration option in Beats is deprecated in favor of using the -ingest geoIP processor plugin. This plugin adds information about the -geographical location of IP addresses, based on data from the Maxmind GeoLite2 -City Database. Because the plugin uses a geoIP database that's installed on -Elasticsearch, you no longer need to install a geoIP database on the -machines running Beats. +The geoIP processor plugin adds information about the geographical location of +IP addresses, based on data from the Maxmind GeoLite2 City Database. Because the +plugin uses a geoIP database that's installed on Elasticsearch, you don't need +to install a geoIP database on the machines running Beats. NOTE: If your use case involves using Logstash, you can use the -{logstashdoc}/plugins-filters-geoip.html[GeoIP filter] available in Logstash +{logstash-ref}/plugins-filters-geoip.html[GeoIP filter] available in Logstash instead of using the ingest plugin. However, using the ingest plugin is the simplest approach when you don't require the additional processing power of Logstash. @@ -28,13 +24,14 @@ Logstash. To configure Packetbeat and the ingest geoIP processor plugin: -1. {plugindoc}/ingest-geoip.html[Install the ingest geoIP processor plugin]. +1. {plugins}/ingest-geoip.html[Install the ingest geoIP processor plugin]. After installing the plugin, remember to restart the node. 2. Define an ingest node pipeline that uses a `geoip` processor to add location info to the event. For example, you can use the Console in Kibana to create the following pipeline: + +-- [source,json] ------------------------------------------------------------------------------- PUT _ingest/pipeline/geoip-info @@ -52,6 +49,8 @@ PUT _ingest/pipeline/geoip-info ] } ------------------------------------------------------------------------------- +//CONSOLE +-- + This pipeline adds a `client_geoip.location` field of type `geo_point` to the event. The ID of the pipeline is `geoip-info`. `client_ip` is the output field @@ -60,7 +59,7 @@ in Packetbeat that contains the IP address of the client. You set when it encounters an event that doesn't have a `client_ip` field. + See -{plugindoc}/using-ingest-geoip.html[Using the Geoip Processor in a Pipeline] +{plugins}/using-ingest-geoip.html[Using the Geoip Processor in a Pipeline] for more options. 3. In the Packetbeat config file, configure the Elasticsearch output to use the @@ -78,7 +77,7 @@ output.elasticsearch: + [source,shell] ------------------------------------------------------------------------------- -./packetbeat -e -c packetbeat.yml +sudo ./packetbeat -e -c packetbeat.yml ------------------------------------------------------------------------------- + The event that's sent to Elasticsearch should now include a @@ -90,9 +89,10 @@ The event that's sent to Elasticsearch should now include a To visualize the location of your Packetbeat clients, you can either <> (if -you haven't already), or create a new {kibana-ref}/tilemap.html[Tile map] in -Kibana and use the `client_geoip.location` field as the Geohash. +you haven't already), or create a new {kibana-ref}/tilemap.html[coordinate map] +in Kibana and use the `client_geoip.location` field as the Geohash. +[role="screenshot"] image:./images/kibana-update-map.png[Update Packetbeat client location map in Kibana] TIP: If the map in the dashboard reports "no results found", and you don't see From 1002bc3731921f16f39e322068ca8fdf99f506aa Mon Sep 17 00:00:00 2001 From: Dmytro Ilchenko Date: Fri, 20 Jul 2018 15:42:47 -0400 Subject: [PATCH 17/34] Document breaking change in monitoring shcema Situation: --- libbeat/docs/breaking.asciidoc | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/libbeat/docs/breaking.asciidoc b/libbeat/docs/breaking.asciidoc index 7b9f5030c7cc..b03c564164e3 100644 --- a/libbeat/docs/breaking.asciidoc +++ b/libbeat/docs/breaking.asciidoc @@ -23,6 +23,10 @@ See the following topics for a description of breaking changes: This section discusses the main changes that you should be aware of if you upgrade the Beats to version 6.3. {see-relnotes} +[[breaking-changes-monitoring]] +=== Filebeat monitoring schema changes +Filebeat monitoring data from Filebaet version <6.3.0 could not be sent to an Elasticsearch cluster version >= 6.3.0 due to renaming of `beat.cpu.*.time metrics` to `beat.cpu.*.time.ms`. {see-relnotes} + [[breaking-changes-mapping-conflict]] ==== New `host` namespace may cause mapping conflicts for Logstash From cc422013c598135a94878a8fbc083bc1eeb6cba3 Mon Sep 17 00:00:00 2001 From: DeDe Morton Date: Fri, 20 Jul 2018 14:08:52 -0700 Subject: [PATCH 18/34] Edit breaking changes statement about monitoring schema changes (#7666) --- libbeat/docs/breaking.asciidoc | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/libbeat/docs/breaking.asciidoc b/libbeat/docs/breaking.asciidoc index b03c564164e3..7c72ee67579c 100644 --- a/libbeat/docs/breaking.asciidoc +++ b/libbeat/docs/breaking.asciidoc @@ -24,8 +24,12 @@ This section discusses the main changes that you should be aware of if you upgrade the Beats to version 6.3. {see-relnotes} [[breaking-changes-monitoring]] -=== Filebeat monitoring schema changes -Filebeat monitoring data from Filebaet version <6.3.0 could not be sent to an Elasticsearch cluster version >= 6.3.0 due to renaming of `beat.cpu.*.time metrics` to `beat.cpu.*.time.ms`. {see-relnotes} +==== Beats monitoring schema changes + +Starting with version 6.3, the monitoring field `beat.cpu.*.time.metrics` is +renamed to `beat.cpu.*.time.ms`. As a result of this change, Beats shippers +released prior to version 6.3 are unable to send monitoring data to clusters +running on Elasticsearch 6.3 and later. {see-relnotes} [[breaking-changes-mapping-conflict]] ==== New `host` namespace may cause mapping conflicts for Logstash From 96eae344dc25b38a1bfea29dd45ce004424e6b20 Mon Sep 17 00:00:00 2001 From: Shaunak Kashyap Date: Sun, 22 Jul 2018 23:42:22 -0700 Subject: [PATCH 19/34] Marking Elasticsearch module and its metricsets as beta (#7662) This PR marks the `elasticsearch` module and all its 8 existing metricsets all as `beta`. Previously only 2 metricsets were marked as `beta` with the remaining 6 marked as `experimental`. --- CHANGELOG.asciidoc | 1 + metricbeat/docs/modules/elasticsearch/index.asciidoc | 2 +- .../modules/elasticsearch/index_recovery.asciidoc | 2 +- .../modules/elasticsearch/index_summary.asciidoc | 2 +- .../docs/modules/elasticsearch/ml_job.asciidoc | 2 +- .../modules/elasticsearch/pending_tasks.asciidoc | 2 +- metricbeat/docs/modules/elasticsearch/shard.asciidoc | 2 +- metricbeat/docs/modules_list.asciidoc | 12 ++++++------ metricbeat/module/elasticsearch/fields.go | 2 +- .../module/elasticsearch/index/_meta/fields.yml | 1 + metricbeat/module/elasticsearch/index/index.go | 2 +- .../elasticsearch/index_recovery/_meta/fields.yml | 1 + .../elasticsearch/index_recovery/index_recovery.go | 2 +- .../elasticsearch/index_summary/_meta/fields.yml | 1 + .../elasticsearch/index_summary/index_summary.go | 2 +- .../module/elasticsearch/ml_job/_meta/fields.yml | 1 + metricbeat/module/elasticsearch/ml_job/ml_job.go | 2 +- .../elasticsearch/pending_tasks/_meta/fields.yml | 1 + .../elasticsearch/pending_tasks/pending_tasks.go | 2 +- .../module/elasticsearch/shard/_meta/fields.yml | 1 + 20 files changed, 25 insertions(+), 18 deletions(-) diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index cebb87ce771f..ad16e87e5692 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -312,6 +312,7 @@ https://github.com/elastic/beats/compare/v6.2.3...master[Check the HEAD diff] - Add Elasticsearch index recovery metricset. {pull}7225[7225] - Run Kafka integration tests on version 1.1.0 {pull}7616[7616] - Release raid and socket metricset from system module as GA. {pull}7658[7658] +- Release elasticsearch module and all its metricsets as beta. {pull}7662[7662] *Packetbeat* diff --git a/metricbeat/docs/modules/elasticsearch/index.asciidoc b/metricbeat/docs/modules/elasticsearch/index.asciidoc index ac7068b734c2..a05076624842 100644 --- a/metricbeat/docs/modules/elasticsearch/index.asciidoc +++ b/metricbeat/docs/modules/elasticsearch/index.asciidoc @@ -5,7 +5,7 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-metricset-elasticsearch-index]] === Elasticsearch index metricset -experimental[] +beta[] include::../../../module/elasticsearch/index/_meta/docs.asciidoc[] diff --git a/metricbeat/docs/modules/elasticsearch/index_recovery.asciidoc b/metricbeat/docs/modules/elasticsearch/index_recovery.asciidoc index 8c18a79e8301..b93dae1af63c 100644 --- a/metricbeat/docs/modules/elasticsearch/index_recovery.asciidoc +++ b/metricbeat/docs/modules/elasticsearch/index_recovery.asciidoc @@ -5,7 +5,7 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-metricset-elasticsearch-index_recovery]] === Elasticsearch index_recovery metricset -experimental[] +beta[] include::../../../module/elasticsearch/index_recovery/_meta/docs.asciidoc[] diff --git a/metricbeat/docs/modules/elasticsearch/index_summary.asciidoc b/metricbeat/docs/modules/elasticsearch/index_summary.asciidoc index 3ec0e62ef19c..41fe56869b17 100644 --- a/metricbeat/docs/modules/elasticsearch/index_summary.asciidoc +++ b/metricbeat/docs/modules/elasticsearch/index_summary.asciidoc @@ -5,7 +5,7 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-metricset-elasticsearch-index_summary]] === Elasticsearch index_summary metricset -experimental[] +beta[] include::../../../module/elasticsearch/index_summary/_meta/docs.asciidoc[] diff --git a/metricbeat/docs/modules/elasticsearch/ml_job.asciidoc b/metricbeat/docs/modules/elasticsearch/ml_job.asciidoc index 5b0a27380f78..374c9dfc6204 100644 --- a/metricbeat/docs/modules/elasticsearch/ml_job.asciidoc +++ b/metricbeat/docs/modules/elasticsearch/ml_job.asciidoc @@ -5,7 +5,7 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-metricset-elasticsearch-ml_job]] === Elasticsearch ml_job metricset -experimental[] +beta[] include::../../../module/elasticsearch/ml_job/_meta/docs.asciidoc[] diff --git a/metricbeat/docs/modules/elasticsearch/pending_tasks.asciidoc b/metricbeat/docs/modules/elasticsearch/pending_tasks.asciidoc index 4a6ed4586f9a..eef6ac66d1a9 100644 --- a/metricbeat/docs/modules/elasticsearch/pending_tasks.asciidoc +++ b/metricbeat/docs/modules/elasticsearch/pending_tasks.asciidoc @@ -5,7 +5,7 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-metricset-elasticsearch-pending_tasks]] === Elasticsearch pending_tasks metricset -experimental[] +beta[] include::../../../module/elasticsearch/pending_tasks/_meta/docs.asciidoc[] diff --git a/metricbeat/docs/modules/elasticsearch/shard.asciidoc b/metricbeat/docs/modules/elasticsearch/shard.asciidoc index c463610725a5..9c13a6544e22 100644 --- a/metricbeat/docs/modules/elasticsearch/shard.asciidoc +++ b/metricbeat/docs/modules/elasticsearch/shard.asciidoc @@ -5,7 +5,7 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-metricset-elasticsearch-shard]] === Elasticsearch shard metricset -experimental[] +beta[] include::../../../module/elasticsearch/shard/_meta/docs.asciidoc[] diff --git a/metricbeat/docs/modules_list.asciidoc b/metricbeat/docs/modules_list.asciidoc index 809bab134b9d..94a0d06d86f5 100644 --- a/metricbeat/docs/modules_list.asciidoc +++ b/metricbeat/docs/modules_list.asciidoc @@ -33,14 +33,14 @@ This file is generated! See scripts/docs_collector.py |<> beta[] |image:./images/icon-no.png[No prebuilt dashboards] | .1+| .1+| |<> beta[] |<> beta[] |image:./images/icon-no.png[No prebuilt dashboards] | -.8+| .8+| |<> experimental[] -|<> experimental[] -|<> experimental[] -|<> experimental[] +.8+| .8+| |<> beta[] +|<> beta[] +|<> beta[] +|<> beta[] |<> beta[] |<> beta[] -|<> experimental[] -|<> experimental[] +|<> beta[] +|<> beta[] |<> beta[] |image:./images/icon-no.png[No prebuilt dashboards] | .3+| .3+| |<> beta[] |<> beta[] diff --git a/metricbeat/module/elasticsearch/fields.go b/metricbeat/module/elasticsearch/fields.go index 196650b03eb8..b917d9823af4 100644 --- a/metricbeat/module/elasticsearch/fields.go +++ b/metricbeat/module/elasticsearch/fields.go @@ -31,5 +31,5 @@ func init() { // Asset returns asset data func Asset() string { - return "eJzsWt1u4zYTvfdTDHIfPYAvvpsP3TYFdrtosgWKovDS4thmwh8tSXnjPn1BSnIkirJkWY69qHVn2T7nzHBmOEPpHl5wNwfkxFiWGiQ63cwALLMc53D3U/3+3QyAokk1yyxTcg7/mwEANH4DQtGc4wxAI0dicA5LtGQGYNBaJtdmDn/dGcPv/nb3NkrbRarkiq3nsCLcuH+uGHJq5h78HiQR2BboLrvLcA5rrfKsvBNR14SrQ6Y8NxZ14j7tv6xQX3D3XWlaux/FLq6mB0pcz5LMOmkZPQcpowcojSUWJyb2mJ42ZGWS4muLqr5cPUQhQLiQdbJgEQ+Z1sPqrgfHXC5gjM0qS3iULjSvS3cdjarUJKnKpW39pILlSq4jX/aY4a4nJxVkLpaoQa0cWS5QWgNMgt1g4eXksDiKHC2GTjyLvILpaJnGKo2JYf9gstxZNMdKXSktiJ1D158Hm+IkOEP2mp0BHvWAeFx7W98tCAphe9p+YQKF0rsLu/ZNfyEHcoMUljvv60pqxN3xypRoTNUW9e69ShQL86fTaz0eedwQTaGS36i9dT4HP11JDEgdUpw200yQhlffmJdKcSTyOOYnnSOwVQUMximJcxtL1hPa/HtlrceNBFSd2xK9Rpt0rPIo/icPCVJR7F7lgnajTFg4CmIW7kZHcDpQIJRqNOYg+7S7b11Ccw+OL7rKdYqTOv7RQx52fEk7mePrnP2OL9mndXxdQtPxzcppchGk+FkLZ5H4rLV53DquSeTdOq5bx9Wr/7iOC26z0i1zb5n7A2ZuZY3gybNanrLDC37aXDSqg/ki2bccQXB4Vsvu1s0SO2Hb9KtaFpBxNkosWfhoNUmmVYrGIF24SUrTRSyKx86FnytwTwm4bQdsTBOTW8IZXVBicVI9TxusxWFhsIHvzG4Amd2gBgKCGcPk2gnCIkpAufv+s90QC6nKOQWpLCwRMqIN0shA0Apg18SeEr7B/8PT7Op6vzPJT+2uvE62RW2YCkfrU/lK1Djl81YM3tf7UuiPj/AgVyosr33tQNzqPssHCKpERR1QV1BW+w2SLGGS2YvV/V+QZOAUNEq9s6F/U60bIcjrZW0Q5HW8CVLJyy/FJyXvJ1iOypZLrsjelOGr8ja2++0oEVylL4THZ4BRJ4IPqwocHDZSp6R0WnQj8E++zKnbwSJEGbMpMElZesRRxpAqXWJCqK9LC1xqoMJXZqzf7quR5XqHqSsaQX604aOa63pOCGDCmXTUzOlJe6rY81Y4pyaZUnyyrHXFs5zLHO6oxFW8Oy1ikgZ66TdO29La69atr67x0M4FfUsKA0IyNKrjJwAfyWtXCNYFZ0herkTxZyQvQyUvrsfRXrYY5m3XT1yJ7C9Fa3OwRu1UHhVycs796YBvWXcNim9Zd21ZZ3K9ZVulz5F4jyX2LfeuQfEt9y6de50d8DpNUsU5plbpybrgn/8Pe9B41g3ogStdh04BT2yH3xhgnY4tDF2zIgxZ9AFC9wVodGT1kDS6oDN7vWiI/tt+j+biykRevoFTkvAD4whmZywKiEP3JaF/wH+RE4e9VzRe5lF2JYBsCeNkyd9XRfh6f4aSMrleWGJeZiH1EWedX2OAXyFV0hImDRAovwD3RR2pnqSHD0ENartQmmLY14192PjgIaENWXuLTGlm44kz5mFrBK75dl6U6YQX8xL4oDTgKxEZdwbl9l6QLGOB9H1eMoELJhffcswxadWn0U91mfBnZh62FYv+5dxTgs8DlMEzMJrO9sax3TADzPizwgFvHxcHtlO5ufHw3CsJqOORN+2rDU/+lJRYDEX8GwAA//8W5g1w" + return "eJzsW92O2zYTvfdTDPZ+9QC++G4+NO0WSBo0mwJFUTi0OLa5yx+FpJx1n74gJXklirJkWRs5qHW3sn3OmeHMcIbS3sMzHpaAnBjLUoNEp7sFgGWW4xLufqrfv1sAUDSpZpllSi7hfwsAgMZ3QCiac1wAaORIDC5hjZYsAAxay+TWLOGvO2P43d/u3k5pu0qV3LDtEjaEG/fLDUNOzdKD34MkAtsC3WUPGS5hq1WelXci6ppwdciU58aiTtxfxw8r1Gc8fFOa1u5HsYur6YES17Mki05aRt+ClNETlMYSixMTe0xPG7IySfGlRVVfrh6iECCMqOoKF7guIljcUyb3qHHXg1NULmyMzSpLeJQuNLtLdx2NqtQkqcqlbX2lguVKbiMf9pjhrkcnFWQu1qhBbRxZLlBaA0yC3WHh/eS0OIocLYZOfBN5BdPZMo1VGhPD/sFkfbBozpW6UVoQu4SuHw82xUlwhhw1OwM86gnxuPW2frcgKIQdafuFCRRKH2Z27av+Qg7kBimsD97XldSIu+MVK9GYqj3qw9yli4V51enNHk992hFNoTKrUavrfA5+ulIZkDqkOG2mmSANb78yr5XiSOR5zI86R2CbChiMUxLnNpZsJ7T598pajxsJtDq3JXqLNulY5VH8jx4SpKLYvcoF7U6ZsKAUxCzcpc7gdKBAKNVozEn2aXfluoTm3hxfdJXrFCd1/CcPedrxJe1kjq9z9ju+ZJ/W8XUJTcc3K6rJRZDisxTUoiCw1mZz69AmkXfr0G4dWq/+8zo0uM1Wt8y9Ze4PmLmVNYInT2p9yc4v+NvMUaM6ns+Sfc0RBIcnte5u9SyxE7ZZv6p1ARlno8SSlY9ik2RapWgM0pWbvDRdxaJ77Bz5sQL3lID7diDHNDG5J5zRFSUWJ9XzuMNafBYGG/jG7A6Q2R1qICCYMUxunSAsogSUu+//tjtiIVU5pyCVhTVCRrRBGhkgWoHtmt5Lwjr4/fxnmx/aXXydbI/aMBWO4pfylahxyqe9GLzf96XQH+/hQW5UWHb72oS41X2WDxBUiYo6oK6g3AV2SLKESWZn2w9+QZKBU9DYApwN/Ztt3QhBXua1QZCX8SZIJedfig9K3k+wHJUtc67I0ZThq/I6zvvtKBFcpc+Ex2eDUSeID5sKHBw2UqekdFp0I/BP1syl28EqRBnV7UjK0jOOOIZU6RITQn1dWmCuQQtfmLF+u69Gmesdsq5oNPnRhpJq3us5OYAJZ9VRs6gn7aliT3vhnJpkSvHJstYVz3Jec7ijElfx7rSISRropd84bUtrr1u3vrrGUzsX9C0pDAjJ0KiOrwC8Jy9dIVgXnCF5vhLFH5E8D5W8uh5He9limLddP3Elsj8Xrc3JGnVQeVTIxTn3pwO+Zd01KL5l3bVlncn1nu2VfovE+1Ri33LvGhTfcm/u3OvsgLdpkirOMbVKT9YF//x/OILGs25AD1zpOnUKeGE7/MoA23RsYeiaFWHIog8QeixAoyOrh6TRBb2x14uG6L/t92gubkzkZR24JAnfMY5gDsaigDh0XxL6B/+znDgcvaJxnkfclQCyJ4yTNf++KsJ/H8hQUia3K0vM8yKkPuOs80sM8AukSlrCpAEC5QfgPqgj1ZN03OGoQW1XSlMM+72xDyEfPCS0IWtvnSnNbDyhxjyEjcA13/KLMl3wgl8C75QGfCEi486g3N4LkmUskH7MVyZwxeTqa445Jq26NfppLxP+LM3DtmLUv+R7SVB6gDJ4LoyyN3uj2e6YAWb82eKAt5uLA96p3N942O6VBNTxiJz2VYhHf6pKLIYi/g0AAP//s2UyNg==" } diff --git a/metricbeat/module/elasticsearch/index/_meta/fields.yml b/metricbeat/module/elasticsearch/index/_meta/fields.yml index 1e9ee0039362..01772e33894d 100644 --- a/metricbeat/module/elasticsearch/index/_meta/fields.yml +++ b/metricbeat/module/elasticsearch/index/_meta/fields.yml @@ -2,6 +2,7 @@ type: group description: > index + release: beta fields: - name: name type: keyword diff --git a/metricbeat/module/elasticsearch/index/index.go b/metricbeat/module/elasticsearch/index/index.go index a4162b4b6be2..622d90794ae7 100644 --- a/metricbeat/module/elasticsearch/index/index.go +++ b/metricbeat/module/elasticsearch/index/index.go @@ -43,7 +43,7 @@ type MetricSet struct { // New create a new instance of the MetricSet func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Experimental("The elasticsearch index metricset is experimental") + cfgwarn.Beta("The elasticsearch index metricset is beta") // TODO: This currently gets index data for all indices. Make it configurable. ms, err := elasticsearch.NewMetricSet(base, statsPath) diff --git a/metricbeat/module/elasticsearch/index_recovery/_meta/fields.yml b/metricbeat/module/elasticsearch/index_recovery/_meta/fields.yml index bd667b6e8ba8..0df224657cd1 100644 --- a/metricbeat/module/elasticsearch/index_recovery/_meta/fields.yml +++ b/metricbeat/module/elasticsearch/index_recovery/_meta/fields.yml @@ -2,6 +2,7 @@ type: group description: > index + release: beta fields: - name: id type: long diff --git a/metricbeat/module/elasticsearch/index_recovery/index_recovery.go b/metricbeat/module/elasticsearch/index_recovery/index_recovery.go index cddc3fa92bba..769839a641ff 100644 --- a/metricbeat/module/elasticsearch/index_recovery/index_recovery.go +++ b/metricbeat/module/elasticsearch/index_recovery/index_recovery.go @@ -45,7 +45,7 @@ type MetricSet struct { // New create a new instance of the MetricSet func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Experimental("The elasticsearch index_recovery metricset is experimental") + cfgwarn.Beta("The elasticsearch index_recovery metricset is beta") config := struct { ActiveOnly bool `config:"index_recovery.active_only"` diff --git a/metricbeat/module/elasticsearch/index_summary/_meta/fields.yml b/metricbeat/module/elasticsearch/index_summary/_meta/fields.yml index 98396cffbec2..0ae26e0201b2 100644 --- a/metricbeat/module/elasticsearch/index_summary/_meta/fields.yml +++ b/metricbeat/module/elasticsearch/index_summary/_meta/fields.yml @@ -2,6 +2,7 @@ type: group description: > index + release: beta fields: - name: primaries type: group diff --git a/metricbeat/module/elasticsearch/index_summary/index_summary.go b/metricbeat/module/elasticsearch/index_summary/index_summary.go index b0744cf4945c..379c6aa60fab 100644 --- a/metricbeat/module/elasticsearch/index_summary/index_summary.go +++ b/metricbeat/module/elasticsearch/index_summary/index_summary.go @@ -52,7 +52,7 @@ type MetricSet struct { // New create a new instance of the MetricSet func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Experimental("The elasticsearch index_summary metricset is experimental") + cfgwarn.Beta("The elasticsearch index_summary metricset is beta") // Get the stats from the local node ms, err := elasticsearch.NewMetricSet(base, statsPath) diff --git a/metricbeat/module/elasticsearch/ml_job/_meta/fields.yml b/metricbeat/module/elasticsearch/ml_job/_meta/fields.yml index 1b321356f2d0..41b7b1b98e86 100644 --- a/metricbeat/module/elasticsearch/ml_job/_meta/fields.yml +++ b/metricbeat/module/elasticsearch/ml_job/_meta/fields.yml @@ -2,6 +2,7 @@ type: group description: > ml + release: beta fields: - name: id type: keyword diff --git a/metricbeat/module/elasticsearch/ml_job/ml_job.go b/metricbeat/module/elasticsearch/ml_job/ml_job.go index 14e834701d01..c712024b9d6b 100644 --- a/metricbeat/module/elasticsearch/ml_job/ml_job.go +++ b/metricbeat/module/elasticsearch/ml_job/ml_job.go @@ -43,7 +43,7 @@ type MetricSet struct { // New creates a new instance of the MetricSet. New is responsible for unpacking // any MetricSet specific configuration options if there are any. func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Experimental("The elasticsearch ml_job metricset is experimental.") + cfgwarn.Beta("The elasticsearch ml_job metricset is beta.") // Get the stats from the local node ms, err := elasticsearch.NewMetricSet(base, jobPath) diff --git a/metricbeat/module/elasticsearch/pending_tasks/_meta/fields.yml b/metricbeat/module/elasticsearch/pending_tasks/_meta/fields.yml index 2b9ad086b387..f30856f860ca 100644 --- a/metricbeat/module/elasticsearch/pending_tasks/_meta/fields.yml +++ b/metricbeat/module/elasticsearch/pending_tasks/_meta/fields.yml @@ -2,6 +2,7 @@ type: group description: > `cluster.pending_task` contains a pending task description. + release: beta fields: - name: insert_order type: long diff --git a/metricbeat/module/elasticsearch/pending_tasks/pending_tasks.go b/metricbeat/module/elasticsearch/pending_tasks/pending_tasks.go index b71507aef5b7..c6cb6d5d0cb1 100644 --- a/metricbeat/module/elasticsearch/pending_tasks/pending_tasks.go +++ b/metricbeat/module/elasticsearch/pending_tasks/pending_tasks.go @@ -53,7 +53,7 @@ type MetricSet struct { // New creates a new instance of the MetricSet. New is responsible for unpacking // any MetricSet specific configuration options if there are any. func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Experimental("The elasticsearch pending_tasks metricset is experimental.") + cfgwarn.Beta("The elasticsearch pending_tasks metricset is beta.") http, err := helper.NewHTTP(base) if err != nil { diff --git a/metricbeat/module/elasticsearch/shard/_meta/fields.yml b/metricbeat/module/elasticsearch/shard/_meta/fields.yml index ee4c7f281fc7..97337cfce0d0 100644 --- a/metricbeat/module/elasticsearch/shard/_meta/fields.yml +++ b/metricbeat/module/elasticsearch/shard/_meta/fields.yml @@ -2,6 +2,7 @@ type: group description: > shard fields + release: beta fields: - name: primary type: boolean From f2e50dfb8edb984c38217ffdbcf2d25fc61465ef Mon Sep 17 00:00:00 2001 From: Steffen Siering Date: Mon, 23 Jul 2018 09:16:48 +0200 Subject: [PATCH 20/34] Increase kafka version in tests to 1.1.1 (#7655) --- testing/environments/docker/kafka/Dockerfile | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/testing/environments/docker/kafka/Dockerfile b/testing/environments/docker/kafka/Dockerfile index 4d9f0d053e25..cda937e25873 100644 --- a/testing/environments/docker/kafka/Dockerfile +++ b/testing/environments/docker/kafka/Dockerfile @@ -4,7 +4,7 @@ ENV KAFKA_HOME /kafka # The advertised host is kafka. This means it will not work if container is started locally and connected from localhost to it ENV KAFKA_ADVERTISED_HOST kafka ENV KAFKA_LOGS_DIR="/kafka-logs" -ENV KAFKA_VERSION 1.0.0 +ENV KAFKA_VERSION 1.1.1 ENV _JAVA_OPTIONS "-Djava.net.preferIPv4Stack=true" ENV TERM=linux From 5544838e2002f6a8bf956bafc25d0df8f34f5437 Mon Sep 17 00:00:00 2001 From: Hossein Taleghani Date: Mon, 23 Jul 2018 13:32:31 +0430 Subject: [PATCH 21/34] Add missing mongodb status fields (#7613) Add `locks`, `global_locks`, `oplatencies` and `process` fields to `status` metricset of MongoDB module. --- CHANGELOG.asciidoc | 1 + metricbeat/docs/fields.asciidoc | 921 ++++++++++++++++-- metricbeat/module/mongodb/fields.go | 2 +- .../module/mongodb/status/_meta/data.json | 331 ++++--- .../module/mongodb/status/_meta/fields.yml | 495 +++++++--- metricbeat/module/mongodb/status/data.go | 146 ++- metricbeat/module/mongodb/status/status.go | 1 - 7 files changed, 1525 insertions(+), 372 deletions(-) diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index ad16e87e5692..dfef2b349e0f 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -310,6 +310,7 @@ https://github.com/elastic/beats/compare/v6.2.3...master[Check the HEAD diff] - Add Elasticsearch ml_job metricsets. {pull}7196[7196] - Add support for bearer token files to HTTP helper. {pull}7527[7527] - Add Elasticsearch index recovery metricset. {pull}7225[7225] +- Add `locks`, `global_locks`, `oplatencies` and `process` fields to `status` metricset of MongoDB module. {pull}7613[7613] - Run Kafka integration tests on version 1.1.0 {pull}7616[7616] - Release raid and socket metricset from system module as GA. {pull}7658[7658] - Release elasticsearch module and all its metricsets as beta. {pull}7662[7662] diff --git a/metricbeat/docs/fields.asciidoc b/metricbeat/docs/fields.asciidoc index 0b812bf59319..15c365785fcf 100644 --- a/metricbeat/docs/fields.asciidoc +++ b/metricbeat/docs/fields.asciidoc @@ -9501,6 +9501,16 @@ type: keyword Instance version. +-- + +*`mongodb.status.process`*:: ++ +-- +type: keyword + +The current MongoDB process. Possible values are mongos or mongod. + + -- *`mongodb.status.uptime.ms`*:: @@ -9574,321 +9584,851 @@ Number of rollovers assertions produced by the server. -- [float] -== background_flushing fields +== connections fields -Data about the process MongoDB uses to write data to disk. This data is only available for instances that use the MMAPv1 storage engine. +Data regarding the current status of incoming connections and availability of the database server. -*`mongodb.status.background_flushing.flushes`*:: +*`mongodb.status.connections.current`*:: + -- type: long -A counter that collects the number of times the database has flushed all writes to disk. +The number of connections to the database server from clients. This number includes the current shell session. Consider the value of `available` to add more context to this datum. -- -*`mongodb.status.background_flushing.total.ms`*:: +*`mongodb.status.connections.available`*:: + -- type: long -The total number of milliseconds (ms) that the mongod processes have spent writing (i.e. flushing) data to disk. Because this is an absolute value, consider the value of `flushes` and `average_ms` to provide better context for this datum. +The number of unused available incoming connections the database can provide. -- -*`mongodb.status.background_flushing.average.ms`*:: +*`mongodb.status.connections.total_created`*:: + -- type: long -The average time spent flushing to disk per flush event. +A count of all incoming connections created to the server. This number includes connections that have since closed. -- -*`mongodb.status.background_flushing.last.ms`*:: +[float] +== extra_info fields + +Platform specific data. + + + +*`mongodb.status.extra_info.heap_usage.bytes`*:: + -- type: long -The amount of time, in milliseconds, that the last flush operation took to complete. +format: bytes + +The total size in bytes of heap space used by the database process. Only available on Unix/Linux. -- -*`mongodb.status.background_flushing.last_finished`*:: +*`mongodb.status.extra_info.page_faults`*:: + -- -type: date +type: long -A timestamp of the last completed flush operation. +The total number of page faults that require disk operations. Page faults refer to operations that require the database server to access data that isn't available in active memory. -- [float] -== connections fields +== global_lock fields -Data regarding the current status of incoming connections and availability of the database server. +Reports on lock state of the database. -*`mongodb.status.connections.current`*:: +*`mongodb.status.global_lock.total_time.us`*:: + -- type: long -The number of connections to the database server from clients. This number includes the current shell session. Consider the value of `available` to add more context to this datum. +The time, in microseconds, since the database last started and created the globalLock. This is roughly equivalent to total server uptime. -- -*`mongodb.status.connections.available`*:: +[float] +== current_queue fields + +The number of operations queued because of a lock. + + + +*`mongodb.status.global_lock.current_queue.total`*:: + -- type: long -The number of unused available incoming connections the database can provide. +The total number of operations queued waiting for the lock (i.e., the sum of current_queue.readers and current_queue.writers). -- -*`mongodb.status.connections.total_created`*:: +*`mongodb.status.global_lock.current_queue.readers`*:: + -- type: long -A count of all incoming connections created to the server. This number includes connections that have since closed. +The number of operations that are currently queued and waiting for the read lock. + + +-- + +*`mongodb.status.global_lock.current_queue.writers`*:: ++ +-- +type: long + +The number of operations that are currently queued and waiting for the write lock. -- [float] -== journaling fields +== active_clients fields -Data about the journaling-related operations and performance. Journaling information only appears for mongod instances that use the MMAPv1 storage engine and have journaling enabled. +The number of connected clients and the read and write operations performed by these clients. -*`mongodb.status.journaling.commits`*:: +*`mongodb.status.global_lock.active_clients.total`*:: + -- type: long -The number of transactions written to the journal during the last journal group commit interval. +Total number of the active client connections performing read or write operations. -- -*`mongodb.status.journaling.journaled.mb`*:: +*`mongodb.status.global_lock.active_clients.readers`*:: + -- type: long -The amount of data in megabytes (MB) written to journal during the last journal group commit interval. +The number of the active client connections performing read operations. -- -*`mongodb.status.journaling.write_to_data_files.mb`*:: +*`mongodb.status.global_lock.active_clients.writers`*:: + -- type: long -The amount of data in megabytes (MB) written from journal to the data files during the last journal group commit interval. +The number of the active client connections performing write operations. -- -*`mongodb.status.journaling.compression`*:: +[float] +== locks fields + +A document that reports for each lock , data on lock s. The possible lock s are global, database, collection, metadata and oplog. The possible s are r, w, R and W which respresent shared, exclusive, intent shared and intent exclusive. +locks..acquire.count. shows the number of times the lock was acquired in the specified mode. locks..wait.count. shows the number of times the locks.acquireCount lock acquisitions encountered waits because the locks were held in a conflicting mode. locks..wait.us. shows the cumulative wait time in microseconds for the lock acquisitions. locks..deadlock.count. shows the number of times the lock acquisitions encountered deadlocks. + + + + +*`mongodb.status.locks.global.acquire.count.r`*:: + -- type: long -The compression ratio of the data written to the journal. +-- +*`mongodb.status.locks.global.acquire.count.w`*:: ++ +-- +type: long -- -*`mongodb.status.journaling.commits_in_write_lock`*:: +*`mongodb.status.locks.global.acquire.count.R`*:: + -- type: long -Count of the commits that occurred while a write lock was held. Commits in a write lock indicate a MongoDB node under a heavy write load and call for further diagnosis. +-- +*`mongodb.status.locks.global.acquire.count.W`*:: ++ +-- +type: long -- -*`mongodb.status.journaling.early_commits`*:: +*`mongodb.status.locks.global.wait.count.r`*:: + -- type: long -The number of times MongoDB requested a commit before the scheduled journal group commit interval. +-- + +*`mongodb.status.locks.global.wait.count.w`*:: ++ +-- +type: long +-- +*`mongodb.status.locks.global.wait.count.R`*:: ++ -- +type: long -[float] -== times fields +-- -Information about the performance of the mongod instance during the various phases of journaling in the last journal group commit interval. +*`mongodb.status.locks.global.wait.count.W`*:: ++ +-- +type: long +-- +*`mongodb.status.locks.global.wait.us.r`*:: ++ +-- +type: long -*`mongodb.status.journaling.times.dt.ms`*:: +-- + +*`mongodb.status.locks.global.wait.us.w`*:: + -- type: long -The amount of time over which MongoDB collected the times data. Use this field to provide context to the other times field values. +-- +*`mongodb.status.locks.global.wait.us.R`*:: ++ +-- +type: long -- -*`mongodb.status.journaling.times.prep_log_buffer.ms`*:: +*`mongodb.status.locks.global.wait.us.W`*:: + -- type: long -The amount of time spent preparing to write to the journal. Smaller values indicate better journal performance. +-- + +*`mongodb.status.locks.global.deadlock.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.global.deadlock.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.global.deadlock.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.global.deadlock.count.W`*:: ++ +-- +type: long + +-- + + +*`mongodb.status.locks.database.acquire.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.acquire.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.acquire.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.acquire.count.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.wait.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.wait.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.wait.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.wait.count.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.wait.us.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.wait.us.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.wait.us.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.wait.us.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.deadlock.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.deadlock.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.deadlock.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.database.deadlock.count.W`*:: ++ +-- +type: long + +-- + + +*`mongodb.status.locks.collection.acquire.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.acquire.count.w`*:: ++ +-- +type: long + +-- +*`mongodb.status.locks.collection.acquire.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.acquire.count.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.wait.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.wait.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.wait.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.wait.count.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.wait.us.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.wait.us.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.wait.us.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.wait.us.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.deadlock.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.deadlock.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.deadlock.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.collection.deadlock.count.W`*:: ++ +-- +type: long + +-- + + +*`mongodb.status.locks.meta_data.acquire.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.acquire.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.acquire.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.acquire.count.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.wait.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.wait.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.wait.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.wait.count.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.wait.us.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.wait.us.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.wait.us.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.wait.us.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.deadlock.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.deadlock.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.deadlock.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.meta_data.deadlock.count.W`*:: ++ +-- +type: long + +-- + + +*`mongodb.status.locks.oplog.acquire.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.acquire.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.acquire.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.acquire.count.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.wait.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.wait.count.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.wait.count.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.wait.count.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.wait.us.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.wait.us.w`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.wait.us.R`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.wait.us.W`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.deadlock.count.r`*:: ++ +-- +type: long + +-- + +*`mongodb.status.locks.oplog.deadlock.count.w`*:: ++ +-- +type: long -- -*`mongodb.status.journaling.times.write_to_journal.ms`*:: +*`mongodb.status.locks.oplog.deadlock.count.R`*:: + -- type: long -The amount of time spent actually writing to the journal. File system speeds and device interfaces can affect performance. - - -- -*`mongodb.status.journaling.times.write_to_data_files.ms`*:: +*`mongodb.status.locks.oplog.deadlock.count.W`*:: + -- type: long -The amount of time spent writing to data files after journaling. File system speeds and device interfaces can affect performance. +-- +[float] +== network fields --- +Platform specific data. -*`mongodb.status.journaling.times.remap_private_view.ms`*:: + + +*`mongodb.status.network.in.bytes`*:: + -- type: long -The amount of time spent remapping copy-on-write memory mapped views. Smaller values indicate better journal performance. +format: bytes + +The amount of network traffic, in bytes, received by this database. -- -*`mongodb.status.journaling.times.commits.ms`*:: +*`mongodb.status.network.out.bytes`*:: + -- type: long -The amount of time spent for commits. +format: bytes + +The amount of network traffic, in bytes, sent from this database. -- -*`mongodb.status.journaling.times.commits_in_write_lock.ms`*:: +*`mongodb.status.network.requests`*:: + -- type: long -The amount of time spent for commits that occurred while a write lock was held. +The total number of requests received by the server. -- [float] -== extra_info fields +== ops.latencies fields -Platform specific data. +Operation latencies for the database as a whole. Only mongod instances report this metric. -*`mongodb.status.extra_info.heap_usage.bytes`*:: +*`mongodb.status.ops.latencies.reads.latency`*:: + -- type: long -format: bytes - -The total size in bytes of heap space used by the database process. Only available on Unix/Linux. +Total combined latency in microseconds. -- -*`mongodb.status.extra_info.page_faults`*:: +*`mongodb.status.ops.latencies.reads.count`*:: + -- type: long -The total number of page faults that require disk operations. Page faults refer to operations that require the database server to access data that isn't available in active memory. +Total number of read operations performed on the collection since startup. -- -[float] -== network fields +*`mongodb.status.ops.latencies.writes.latency`*:: ++ +-- +type: long -Platform specific data. +Total combined latency in microseconds. +-- -*`mongodb.status.network.in.bytes`*:: +*`mongodb.status.ops.latencies.writes.count`*:: + -- type: long -format: bytes - -The amount of network traffic, in bytes, received by this database. +Total number of write operations performed on the collection since startup. -- -*`mongodb.status.network.out.bytes`*:: +*`mongodb.status.ops.latencies.commands.latency`*:: + -- type: long -format: bytes - -The amount of network traffic, in bytes, sent from this database. +Total combined latency in microseconds. -- -*`mongodb.status.network.requests`*:: +*`mongodb.status.ops.latencies.commands.count`*:: + -- type: long -The total number of requests received by the server. +Total number of commands performed on the collection since startup. -- [float] -== opcounters fields +== ops.counters fields An overview of database operations by type. -*`mongodb.status.opcounters.insert`*:: +*`mongodb.status.ops.counters.insert`*:: + -- type: long @@ -9898,7 +10438,7 @@ The total number of insert operations received since the mongod instance last st -- -*`mongodb.status.opcounters.query`*:: +*`mongodb.status.ops.counters.query`*:: + -- type: long @@ -9908,7 +10448,7 @@ The total number of queries received since the mongod instance last started. -- -*`mongodb.status.opcounters.update`*:: +*`mongodb.status.ops.counters.update`*:: + -- type: long @@ -9918,7 +10458,7 @@ The total number of update operations received since the mongod instance last st -- -*`mongodb.status.opcounters.delete`*:: +*`mongodb.status.ops.counters.delete`*:: + -- type: long @@ -9928,7 +10468,7 @@ The total number of delete operations received since the mongod instance last st -- -*`mongodb.status.opcounters.getmore`*:: +*`mongodb.status.ops.counters.getmore`*:: + -- type: long @@ -9938,7 +10478,7 @@ The total number of getmore operations received since the mongod instance last s -- -*`mongodb.status.opcounters.command`*:: +*`mongodb.status.ops.counters.command`*:: + -- type: long @@ -9949,13 +10489,13 @@ The total number of commands issued to the database since the mongod instance la -- [float] -== opcounters_replicated fields +== ops.replicated fields An overview of database replication operations by type. -*`mongodb.status.opcounters_replicated.insert`*:: +*`mongodb.status.ops.replicated.insert`*:: + -- type: long @@ -9965,7 +10505,7 @@ The total number of replicated insert operations received since the mongod insta -- -*`mongodb.status.opcounters_replicated.query`*:: +*`mongodb.status.ops.replicated.query`*:: + -- type: long @@ -9975,7 +10515,7 @@ The total number of replicated queries received since the mongod instance last s -- -*`mongodb.status.opcounters_replicated.update`*:: +*`mongodb.status.ops.replicated.update`*:: + -- type: long @@ -9985,7 +10525,7 @@ The total number of replicated update operations received since the mongod insta -- -*`mongodb.status.opcounters_replicated.delete`*:: +*`mongodb.status.ops.replicated.delete`*:: + -- type: long @@ -9995,7 +10535,7 @@ The total number of replicated delete operations received since the mongod insta -- -*`mongodb.status.opcounters_replicated.getmore`*:: +*`mongodb.status.ops.replicated.getmore`*:: + -- type: long @@ -10005,7 +10545,7 @@ The total number of replicated getmore operations received since the mongod inst -- -*`mongodb.status.opcounters_replicated.command`*:: +*`mongodb.status.ops.replicated.command`*:: + -- type: long @@ -10320,6 +10860,207 @@ type: long Number of sync operations. +-- + +[float] +== background_flushing fields + +Data about the process MongoDB uses to write data to disk. This data is only available for instances that use the MMAPv1 storage engine. + + + +*`mongodb.status.background_flushing.flushes`*:: ++ +-- +type: long + +A counter that collects the number of times the database has flushed all writes to disk. + + +-- + +*`mongodb.status.background_flushing.total.ms`*:: ++ +-- +type: long + +The total number of milliseconds (ms) that the mongod processes have spent writing (i.e. flushing) data to disk. Because this is an absolute value, consider the value of `flushes` and `average_ms` to provide better context for this datum. + + +-- + +*`mongodb.status.background_flushing.average.ms`*:: ++ +-- +type: long + +The average time spent flushing to disk per flush event. + + +-- + +*`mongodb.status.background_flushing.last.ms`*:: ++ +-- +type: long + +The amount of time, in milliseconds, that the last flush operation took to complete. + + +-- + +*`mongodb.status.background_flushing.last_finished`*:: ++ +-- +type: date + +A timestamp of the last completed flush operation. + + +-- + +[float] +== journaling fields + +Data about the journaling-related operations and performance. Journaling information only appears for mongod instances that use the MMAPv1 storage engine and have journaling enabled. + + + +*`mongodb.status.journaling.commits`*:: ++ +-- +type: long + +The number of transactions written to the journal during the last journal group commit interval. + + +-- + +*`mongodb.status.journaling.journaled.mb`*:: ++ +-- +type: long + +The amount of data in megabytes (MB) written to journal during the last journal group commit interval. + + +-- + +*`mongodb.status.journaling.write_to_data_files.mb`*:: ++ +-- +type: long + +The amount of data in megabytes (MB) written from journal to the data files during the last journal group commit interval. + + +-- + +*`mongodb.status.journaling.compression`*:: ++ +-- +type: long + +The compression ratio of the data written to the journal. + + +-- + +*`mongodb.status.journaling.commits_in_write_lock`*:: ++ +-- +type: long + +Count of the commits that occurred while a write lock was held. Commits in a write lock indicate a MongoDB node under a heavy write load and call for further diagnosis. + + +-- + +*`mongodb.status.journaling.early_commits`*:: ++ +-- +type: long + +The number of times MongoDB requested a commit before the scheduled journal group commit interval. + + +-- + +[float] +== times fields + +Information about the performance of the mongod instance during the various phases of journaling in the last journal group commit interval. + + + +*`mongodb.status.journaling.times.dt.ms`*:: ++ +-- +type: long + +The amount of time over which MongoDB collected the times data. Use this field to provide context to the other times field values. + + +-- + +*`mongodb.status.journaling.times.prep_log_buffer.ms`*:: ++ +-- +type: long + +The amount of time spent preparing to write to the journal. Smaller values indicate better journal performance. + + +-- + +*`mongodb.status.journaling.times.write_to_journal.ms`*:: ++ +-- +type: long + +The amount of time spent actually writing to the journal. File system speeds and device interfaces can affect performance. + + +-- + +*`mongodb.status.journaling.times.write_to_data_files.ms`*:: ++ +-- +type: long + +The amount of time spent writing to data files after journaling. File system speeds and device interfaces can affect performance. + + +-- + +*`mongodb.status.journaling.times.remap_private_view.ms`*:: ++ +-- +type: long + +The amount of time spent remapping copy-on-write memory mapped views. Smaller values indicate better journal performance. + + +-- + +*`mongodb.status.journaling.times.commits.ms`*:: ++ +-- +type: long + +The amount of time spent for commits. + + +-- + +*`mongodb.status.journaling.times.commits_in_write_lock.ms`*:: ++ +-- +type: long + +The amount of time spent for commits that occurred while a write lock was held. + + -- [[exported-fields-munin]] diff --git a/metricbeat/module/mongodb/fields.go b/metricbeat/module/mongodb/fields.go index 1a8c14c4327b..92740eaf6620 100644 --- a/metricbeat/module/mongodb/fields.go +++ b/metricbeat/module/mongodb/fields.go @@ -31,5 +31,5 @@ func init() { // Asset returns asset data func Asset() string { - return "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" + return "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" } diff --git a/metricbeat/module/mongodb/status/_meta/data.json b/metricbeat/module/mongodb/status/_meta/data.json index 0fa0f5894426..7fd0937fc7d5 100644 --- a/metricbeat/module/mongodb/status/_meta/data.json +++ b/metricbeat/module/mongodb/status/_meta/data.json @@ -1,126 +1,209 @@ { - "@timestamp": "2017-10-12T08:05:34.853Z", - "beat": { - "hostname": "host.example.com", - "name": "host.example.com" - }, - "metricset": { - "host": "mongodb:27017", - "module": "mongodb", - "name": "status", - "rtt": 115 - }, - "mongodb": { - "status": { - "asserts": { - "msg": 0, - "regular": 0, - "rollovers": 0, - "user": 0, - "warning": 0 - }, - "connections": { - "available": 838859, - "current": 1, - "total_created": 86 - }, - "extra_info": { - "heap_usage": {}, - "page_faults": 31707 - }, - "local_time": "2017-12-07T07:31:22.865Z", - "memory": { - "bits": 64, - "mapped": { - "mb": 0 + "@timestamp": "2017-10-12T08:05:34.853Z", + "beat": { + "hostname": "host.example.com", + "name": "host.example.com" + }, + "metricset": { + "host": "mongodb:27017", + "module": "mongodb", + "name": "status", + "rtt": 115 + }, + "mongodb": { + "status": { + "version": "3.4.7", + "ops": { + "latencies": { + "writes": { + "latency": 0, + "count": 0 + }, + "commands": { + "latency": 439756604, + "count": 7607434 + }, + "reads": { + "count": 19245, + "latency": 5504505 + } + }, + "counters": { + "update": 0, + "delete": 0, + "getmore": 14, + "command": 7607435, + "insert": 0, + "query": 19200 + }, + "replicated": { + "query": 0, + "update": 0, + "delete": 0, + "getmore": 0, + "command": 0, + "insert": 0 + } + }, + "uptime": { + "ms": 4909716080 + }, + "asserts": { + "warning": 0, + "msg": 0, + "user": 32, + "rollovers": 0, + "regular": 0 + }, + "local_time": "2018-07-17T18:31:45.823Z", + "global_lock": { + "total_time": { + "us": 4909712143000 }, - "mapped_with_journal": { - "mb": 0 - }, - "resident": { - "mb": 11 - }, - "virtual": { - "mb": 931 - } - }, - "network": { - "in": { - "bytes": 811 - }, - "out": { - "bytes": 24792 - }, - "requests": 27 - }, - "opcounters": { - "command": 14, - "delete": 0, - "getmore": 0, - "insert": 0, - "query": 1, - "update": 0 - }, - "opcounters_replicated": { - "command": 0, - "delete": 0, - "getmore": 0, - "insert": 0, - "query": 0, - "update": 0 - }, - "storage_engine": { - "name": "wiredTiger" - }, - "uptime": { - "ms": 652234 - }, - "version": "3.4.10", - "wired_tiger": { - "cache": { - "dirty": { - "bytes": 0 - }, - "maximum": { - "bytes": 1531969536 - }, - "pages": { - "evicted": 0, - "read": 0, - "write": 16 - }, - "used": { - "bytes": 29567 - } - }, - "concurrent_transactions": { - "read": { - "available": 128, - "out": 0, - "total_tickets": 128 - }, - "write": { - "available": 128, - "out": 0, - "total_tickets": 128 - } - }, - "log": { - "flushes": 3514, - "max_file_size": { - "bytes": 104857600 - }, - "scans": 0, - "size": { - "bytes": 33554432 - }, - "syncs": 18, - "write": { - "bytes": 16640 - }, - "writes": 42 - } - } - } - } -} \ No newline at end of file + "current_queue": { + "total": 0, + "readers": 0, + "writers": 0 + }, + "active_clients": { + "readers": 0, + "writers": 0, + "total": 19 + } + }, + "network": { + "out": { + "bytes": 5137630772 + }, + "requests": 15253359, + "in": { + "bytes": 973355182 + } + }, + "locks": { + "oplog": { + "acquire": { + "count": { + "r": 4909608 + } + }, + "wait": {}, + "deadlock": {} + }, + "global": { + "wait": {}, + "deadlock": {}, + "acquire": { + "count": { + "w": 22, + "W": 2, + "r": 17350359 + } + } + }, + "database": { + "wait": {}, + "deadlock": {}, + "acquire": { + "count": { + "R": 21447, + "W": 22, + "r": 11087051 + } + } + }, + "collection": { + "wait": {}, + "deadlock": {}, + "acquire": { + "count": { + "r": 6155983 + } + } + }, + "meta_data": { + "acquire": { + "count": { + "w": 1 + } + }, + "wait": {}, + "deadlock": {} + } + }, + "wired_tiger": { + "cache": { + "maximum": { + "bytes": 1534066688 + }, + "used": { + "bytes": 65472 + }, + "dirty": { + "bytes": 0 + }, + "pages": { + "write": 63, + "evicted": 0, + "read": 18 + } + }, + "log": { + "syncs": 38, + "size": { + "bytes": 33554432 + }, + "write": { + "bytes": 15104 + }, + "max_file_size": { + "bytes": 104857600 + }, + "flushes": 49022011, + "writes": 47, + "scans": 5 + }, + "concurrent_transactions": { + "write": { + "available": 128, + "total_tickets": 128, + "out": 0 + }, + "read": { + "available": 128, + "total_tickets": 128, + "out": 0 + } + } + }, + "storage_engine": { + "name": "wiredTiger" + }, + "process": "mongod", + "memory": { + "mapped": { + "mb": 0 + }, + "mapped_with_journal": { + "mb": 0 + }, + "bits": 64, + "resident": { + "mb": 21 + }, + "virtual": { + "mb": 1024 + } + }, + "connections": { + "total_created": 66310, + "current": 11, + "available": 51189 + }, + "extra_info": { + "page_faults": 1197, + "heap_usage": {} + } + } + } +} diff --git a/metricbeat/module/mongodb/status/_meta/fields.yml b/metricbeat/module/mongodb/status/_meta/fields.yml index c692f345736d..d3cbb3b88a89 100644 --- a/metricbeat/module/mongodb/status/_meta/fields.yml +++ b/metricbeat/module/mongodb/status/_meta/fields.yml @@ -8,6 +8,10 @@ type: keyword description: > Instance version. + - name: process + type: keyword + description: > + The current MongoDB process. Possible values are mongos or mongod. - name: uptime.ms type: long description: > @@ -38,38 +42,6 @@ description: > Number of rollovers assertions produced by the server. - - name: background_flushing - type: group - description: > - Data about the process MongoDB uses to write data to disk. This data is - only available for instances that use the MMAPv1 storage engine. - fields: - - name: flushes - type: long - description: > - A counter that collects the number of times the database has - flushed all writes to disk. - - name: total.ms - type: long - description: > - The total number of milliseconds (ms) that the mongod processes have - spent writing (i.e. flushing) data to disk. Because this is an - absolute value, consider the value of `flushes` and `average_ms` to - provide better context for this datum. - - name: average.ms - type: long - description: > - The average time spent flushing to disk per flush event. - - name: last.ms - type: long - description: > - The amount of time, in milliseconds, that the last flush operation - took to complete. - - name: last_finished - type: date - description: > - A timestamp of the last completed flush operation. - - name: connections type: group description: > @@ -93,85 +65,6 @@ A count of all incoming connections created to the server. This number includes connections that have since closed. - - name: journaling - type: group - description: > - Data about the journaling-related operations and performance. Journaling - information only appears for mongod instances that use the MMAPv1 - storage engine and have journaling enabled. - fields: - - name: commits - type: long - description: > - The number of transactions written to the journal during the last - journal group commit interval. - - name: journaled.mb - type: long - description: > - The amount of data in megabytes (MB) written to journal during the - last journal group commit interval. - - name: write_to_data_files.mb - type: long - description: > - The amount of data in megabytes (MB) written from journal to the - data files during the last journal group commit interval. - - name: compression - type: long - description: > - The compression ratio of the data written to the journal. - - name: commits_in_write_lock - type: long - description: > - Count of the commits that occurred while a write lock was held. - Commits in a write lock indicate a MongoDB node under a heavy write - load and call for further diagnosis. - - name: early_commits - type: long - description: > - The number of times MongoDB requested a commit before the scheduled - journal group commit interval. - - name: times - type: group - description: > - Information about the performance of the mongod instance during the - various phases of journaling in the last journal group commit - interval. - fields: - - name: dt.ms - type: long - description: > - The amount of time over which MongoDB collected the times data. - Use this field to provide context to the other times field values. - - name: prep_log_buffer.ms - type: long - description: > - The amount of time spent preparing to write to the journal. - Smaller values indicate better journal performance. - - name: write_to_journal.ms - type: long - description: > - The amount of time spent actually writing to the journal. File - system speeds and device interfaces can affect performance. - - name: write_to_data_files.ms - type: long - description: > - The amount of time spent writing to data files after journaling. - File system speeds and device interfaces can affect performance. - - name: remap_private_view.ms - type: long - description: > - The amount of time spent remapping copy-on-write memory mapped - views. Smaller values indicate better journal performance. - - name: commits.ms - type: long - description: > - The amount of time spent for commits. - - name: commits_in_write_lock.ms - type: long - description: > - The amount of time spent for commits that occurred while a write - lock was held. - - name: extra_info type: group description: > @@ -190,6 +83,239 @@ faults refer to operations that require the database server to access data that isn't available in active memory. + - name: global_lock + type: group + description: > + Reports on lock state of the database. + fields: + - name: total_time.us + type: long + description: > + The time, in microseconds, since the database last started and created the globalLock. + This is roughly equivalent to total server uptime. + - name: current_queue + type: group + description: > + The number of operations queued because of a lock. + fields: + - name: total + type: long + description: > + The total number of operations queued waiting for the lock (i.e., the sum of current_queue.readers and current_queue.writers). + - name: readers + type: long + description: > + The number of operations that are currently queued and waiting for the read lock. + - name: writers + type: long + description: > + The number of operations that are currently queued and waiting for the write lock. + - name: active_clients + type: group + description: > + The number of connected clients and the read and write operations performed by these clients. + fields: + - name: total + type: long + description: > + Total number of the active client connections performing read or write operations. + - name: readers + type: long + description: > + The number of the active client connections performing read operations. + - name: writers + type: long + description: > + The number of the active client connections performing write operations. + - name: locks + type: group + description: > + A document that reports for each lock , data on lock s. + The possible lock s are global, database, collection, metadata and oplog. + The possible s are r, w, R and W which respresent shared, exclusive, intent shared and intent exclusive. + + locks..acquire.count. shows the number of times the lock was acquired in the specified mode. + locks..wait.count. shows the number of times the locks.acquireCount lock acquisitions encountered waits + because the locks were held in a conflicting mode. + locks..wait.us. shows the cumulative wait time in microseconds for the lock acquisitions. + locks..deadlock.count. shows the number of times the lock acquisitions encountered deadlocks. + fields: + - name: global + type: group + fields: + - name: acquire.count.r + type: long + - name: acquire.count.w + type: long + - name: acquire.count.R + type: long + - name: acquire.count.W + type: long + - name: wait.count.r + type: long + - name: wait.count.w + type: long + - name: wait.count.R + type: long + - name: wait.count.W + type: long + - name: wait.us.r + type: long + - name: wait.us.w + type: long + - name: wait.us.R + type: long + - name: wait.us.W + type: long + - name: deadlock.count.r + type: long + - name: deadlock.count.w + type: long + - name: deadlock.count.R + type: long + - name: deadlock.count.W + type: long + - name: database + type: group + fields: + - name: acquire.count.r + type: long + - name: acquire.count.w + type: long + - name: acquire.count.R + type: long + - name: acquire.count.W + type: long + - name: wait.count.r + type: long + - name: wait.count.w + type: long + - name: wait.count.R + type: long + - name: wait.count.W + type: long + - name: wait.us.r + type: long + - name: wait.us.w + type: long + - name: wait.us.R + type: long + - name: wait.us.W + type: long + - name: deadlock.count.r + type: long + - name: deadlock.count.w + type: long + - name: deadlock.count.R + type: long + - name: deadlock.count.W + type: long + - name: collection + type: group + fields: + - name: acquire.count.r + type: long + - name: acquire.count.w + type: long + - name: acquire.count.R + type: long + - name: acquire.count.W + type: long + - name: wait.count.r + type: long + - name: wait.count.w + type: long + - name: wait.count.R + type: long + - name: wait.count.W + type: long + - name: wait.us.r + type: long + - name: wait.us.w + type: long + - name: wait.us.R + type: long + - name: wait.us.W + type: long + - name: deadlock.count.r + type: long + - name: deadlock.count.w + type: long + - name: deadlock.count.R + type: long + - name: deadlock.count.W + type: long + - name: meta_data + type: group + fields: + - name: acquire.count.r + type: long + - name: acquire.count.w + type: long + - name: acquire.count.R + type: long + - name: acquire.count.W + type: long + - name: wait.count.r + type: long + - name: wait.count.w + type: long + - name: wait.count.R + type: long + - name: wait.count.W + type: long + - name: wait.us.r + type: long + - name: wait.us.w + type: long + - name: wait.us.R + type: long + - name: wait.us.W + type: long + - name: deadlock.count.r + type: long + - name: deadlock.count.w + type: long + - name: deadlock.count.R + type: long + - name: deadlock.count.W + type: long + - name: oplog + type: group + fields: + - name: acquire.count.r + type: long + - name: acquire.count.w + type: long + - name: acquire.count.R + type: long + - name: acquire.count.W + type: long + - name: wait.count.r + type: long + - name: wait.count.w + type: long + - name: wait.count.R + type: long + - name: wait.count.W + type: long + - name: wait.us.r + type: long + - name: wait.us.w + type: long + - name: wait.us.R + type: long + - name: wait.us.W + type: long + - name: deadlock.count.r + type: long + - name: deadlock.count.w + type: long + - name: deadlock.count.R + type: long + - name: deadlock.count.W + type: long + - name: network type: group description: > @@ -210,7 +336,38 @@ description: > The total number of requests received by the server. - - name: opcounters + - name: ops.latencies + type: group + description: > + Operation latencies for the database as a whole. + Only mongod instances report this metric. + fields: + - name: reads.latency + type: long + description: > + Total combined latency in microseconds. + - name: reads.count + type: long + description: > + Total number of read operations performed on the collection since startup. + - name: writes.latency + type: long + description: > + Total combined latency in microseconds. + - name: writes.count + type: long + description: > + Total number of write operations performed on the collection since startup. + - name: commands.latency + type: long + description: > + Total combined latency in microseconds. + - name: commands.count + type: long + description: > + Total number of commands performed on the collection since startup. + + - name: ops.counters type: group description: > An overview of database operations by type. @@ -246,7 +403,7 @@ The total number of commands issued to the database since the mongod instance last started. - - name: opcounters_replicated + - name: ops.replicated type: group description: > An overview of database replication operations by type. @@ -425,3 +582,115 @@ type: long description: > Number of sync operations. + + - name: background_flushing + type: group + description: > + Data about the process MongoDB uses to write data to disk. This data is + only available for instances that use the MMAPv1 storage engine. + fields: + - name: flushes + type: long + description: > + A counter that collects the number of times the database has + flushed all writes to disk. + - name: total.ms + type: long + description: > + The total number of milliseconds (ms) that the mongod processes have + spent writing (i.e. flushing) data to disk. Because this is an + absolute value, consider the value of `flushes` and `average_ms` to + provide better context for this datum. + - name: average.ms + type: long + description: > + The average time spent flushing to disk per flush event. + - name: last.ms + type: long + description: > + The amount of time, in milliseconds, that the last flush operation + took to complete. + - name: last_finished + type: date + description: > + A timestamp of the last completed flush operation. + + - name: journaling + type: group + description: > + Data about the journaling-related operations and performance. Journaling + information only appears for mongod instances that use the MMAPv1 + storage engine and have journaling enabled. + fields: + - name: commits + type: long + description: > + The number of transactions written to the journal during the last + journal group commit interval. + - name: journaled.mb + type: long + description: > + The amount of data in megabytes (MB) written to journal during the + last journal group commit interval. + - name: write_to_data_files.mb + type: long + description: > + The amount of data in megabytes (MB) written from journal to the + data files during the last journal group commit interval. + - name: compression + type: long + description: > + The compression ratio of the data written to the journal. + - name: commits_in_write_lock + type: long + description: > + Count of the commits that occurred while a write lock was held. + Commits in a write lock indicate a MongoDB node under a heavy write + load and call for further diagnosis. + - name: early_commits + type: long + description: > + The number of times MongoDB requested a commit before the scheduled + journal group commit interval. + - name: times + type: group + description: > + Information about the performance of the mongod instance during the + various phases of journaling in the last journal group commit + interval. + fields: + - name: dt.ms + type: long + description: > + The amount of time over which MongoDB collected the times data. + Use this field to provide context to the other times field values. + - name: prep_log_buffer.ms + type: long + description: > + The amount of time spent preparing to write to the journal. + Smaller values indicate better journal performance. + - name: write_to_journal.ms + type: long + description: > + The amount of time spent actually writing to the journal. File + system speeds and device interfaces can affect performance. + - name: write_to_data_files.ms + type: long + description: > + The amount of time spent writing to data files after journaling. + File system speeds and device interfaces can affect performance. + - name: remap_private_view.ms + type: long + description: > + The amount of time spent remapping copy-on-write memory mapped + views. Smaller values indicate better journal performance. + - name: commits.ms + type: long + description: > + The amount of time spent for commits. + - name: commits_in_write_lock.ms + type: long + description: > + The amount of time spent for commits that occurred while a write + lock was held. + diff --git a/metricbeat/module/mongodb/status/data.go b/metricbeat/module/mongodb/status/data.go index d1293128aa0a..749a69768ca0 100644 --- a/metricbeat/module/mongodb/status/data.go +++ b/metricbeat/module/mongodb/status/data.go @@ -24,11 +24,11 @@ import ( var schema = s.Schema{ "version": c.Str("version"), + "process": c.Str("process"), "uptime": s.Object{ "ms": c.Int("uptimeMillis"), }, - "local_time": c.Time("localTime"), - "write_backs_queued": c.Bool("writeBacksQueued", s.Optional), + "local_time": c.Time("localTime"), "asserts": c.Dict("asserts", s.Schema{ "regular": c.Int("regular"), "warning": c.Int("warning"), @@ -36,6 +36,74 @@ var schema = s.Schema{ "user": c.Int("user"), "rollovers": c.Int("rollovers"), }), + "connections": c.Dict("connections", s.Schema{ + "current": c.Int("current"), + "available": c.Int("available"), + "total_created": c.Int("totalCreated"), + }), + "extra_info": c.Dict("extra_info", s.Schema{ + "heap_usage": s.Object{"bytes": c.Int("heap_usage_bytes", s.Optional)}, + "page_faults": c.Int("page_faults"), + }), + "global_lock": c.Dict("globalLock", s.Schema{ + "total_time": s.Object{"us": c.Int("totalTime")}, + "current_queue": c.Dict("currentQueue", globalLockItemSchema), + "active_clients": c.Dict("activeClients", globalLockItemSchema), + }), + "locks": c.Dict("locks", s.Schema{ + "global": c.Dict("Global", lockItemSchema), + "database": c.Dict("Database", lockItemSchema), + "collection": c.Dict("Collection", lockItemSchema), + "meta_data": c.Dict("Metadata", lockItemSchema), + "oplog": c.Dict("oplog", lockItemSchema), + }), + "network": c.Dict("network", s.Schema{ + "in": s.Object{"bytes": c.Int("bytesIn")}, + "out": s.Object{"bytes": c.Int("bytesOut")}, + "requests": c.Int("numRequests"), + }), + "ops": s.Object{ + "latencies": c.Dict("opLatencies", s.Schema{ + "reads": c.Dict("reads", opLatenciesItemSchema), + "writes": c.Dict("writes", opLatenciesItemSchema), + "commands": c.Dict("commands", opLatenciesItemSchema), + }, c.DictOptional), + "counters": c.Dict("opcounters", s.Schema{ + "insert": c.Int("insert"), + "query": c.Int("query"), + "update": c.Int("update"), + "delete": c.Int("delete"), + "getmore": c.Int("getmore"), + "command": c.Int("command"), + }), + "replicated": c.Dict("opcountersRepl", s.Schema{ + "insert": c.Int("insert"), + "query": c.Int("query"), + "update": c.Int("update"), + "delete": c.Int("delete"), + "getmore": c.Int("getmore"), + "command": c.Int("command"), + }), + }, + // ToDo add `repl` field + "storage_engine": c.Dict("storageEngine", s.Schema{ + "name": c.Str("name"), + // supportsCommitedReads boolean + // readOnly boolean + // persistent boolean + }), + // ToDo add `tcmalloc` field + "wired_tiger": c.Dict("wiredTiger", wiredTigerSchema, c.DictOptional), + "write_backs_queued": c.Bool("writeBacksQueued", s.Optional), + "memory": c.Dict("mem", s.Schema{ + "bits": c.Int("bits"), + "resident": s.Object{"mb": c.Int("resident")}, + "virtual": s.Object{"mb": c.Int("virtual")}, + "mapped": s.Object{"mb": c.Int("mapped")}, + "mapped_with_journal": s.Object{"mb": c.Int("mappedWithJournal")}, + }), + + // MMPAV1 only "background_flushing": c.Dict("backgroundFlushing", s.Schema{ "flushes": c.Int("flushes"), "total": s.Object{ @@ -49,11 +117,8 @@ var schema = s.Schema{ }, "last_finished": c.Time("last_finished"), }, c.DictOptional), - "connections": c.Dict("connections", s.Schema{ - "current": c.Int("current"), - "available": c.Int("available"), - "total_created": c.Int("totalCreated"), - }), + + // MMPAV1 only "journaling": c.Dict("dur", s.Schema{ "commits": c.Int("commits"), "journaled": s.Object{ @@ -75,42 +140,6 @@ var schema = s.Schema{ "commits_in_write_lock": s.Object{"ms": c.Int("commitsInWriteLock")}, }), }, c.DictOptional), - "extra_info": c.Dict("extra_info", s.Schema{ - "heap_usage": s.Object{"bytes": c.Int("heap_usage_bytes", s.Optional)}, - "page_faults": c.Int("page_faults"), - }), - "network": c.Dict("network", s.Schema{ - "in": s.Object{"bytes": c.Int("bytesIn")}, - "out": s.Object{"bytes": c.Int("bytesOut")}, - "requests": c.Int("numRequests"), - }), - "memory": c.Dict("mem", s.Schema{ - "bits": c.Int("bits"), - "resident": s.Object{"mb": c.Int("resident")}, - "virtual": s.Object{"mb": c.Int("virtual")}, - "mapped": s.Object{"mb": c.Int("mapped")}, - "mapped_with_journal": s.Object{"mb": c.Int("mappedWithJournal")}, - }), - "opcounters": c.Dict("opcounters", s.Schema{ - "insert": c.Int("insert"), - "query": c.Int("query"), - "update": c.Int("update"), - "delete": c.Int("delete"), - "getmore": c.Int("getmore"), - "command": c.Int("command"), - }), - "opcounters_replicated": c.Dict("opcountersRepl", s.Schema{ - "insert": c.Int("insert"), - "query": c.Int("query"), - "update": c.Int("update"), - "delete": c.Int("delete"), - "getmore": c.Int("getmore"), - "command": c.Int("command"), - }), - "storage_engine": c.Dict("storageEngine", s.Schema{ - "name": c.Str("name"), - }), - "wired_tiger": c.Dict("wiredTiger", wiredTigerSchema, c.DictOptional), } var wiredTigerSchema = s.Schema{ @@ -146,3 +175,34 @@ var wiredTigerSchema = s.Schema{ "syncs": c.Int("log sync operations"), }), } + +var globalLockItemSchema = s.Schema{ + "total": c.Int("total"), + "readers": c.Int("readers"), + "writers": c.Int("writers"), +} + +var lockItemSchema = s.Schema{ + "acquire": s.Object{ + "count": c.Dict("acquireCount", lockItemModesSchema, c.DictOptional), + }, + "wait": s.Object{ + "count": c.Dict("acquireWaitCount", lockItemModesSchema, c.DictOptional), + "us": c.Dict("timeAcquiringMicros", lockItemModesSchema, c.DictOptional), + }, + "deadlock": s.Object{ + "count": c.Dict("deadlockCount", lockItemModesSchema, c.DictOptional), + }, +} + +var lockItemModesSchema = s.Schema{ + "r": c.Int("r", s.Optional), + "w": c.Int("w", s.Optional), + "R": c.Int("R", s.Optional), + "W": c.Int("W", s.Optional), +} + +var opLatenciesItemSchema = s.Schema{ + "latency": c.Int("latency"), + "count": c.Int("ops"), +} diff --git a/metricbeat/module/mongodb/status/status.go b/metricbeat/module/mongodb/status/status.go index 07e643ef4ca9..e7c2bc810a45 100644 --- a/metricbeat/module/mongodb/status/status.go +++ b/metricbeat/module/mongodb/status/status.go @@ -28,7 +28,6 @@ import ( /* TODOs: - * add metricset for "locks" data * add a metricset for "metrics" data */ From b2fb25ddd957d68c3247f4f5e7025c06fa7ca1d2 Mon Sep 17 00:00:00 2001 From: Silvia Mitter Date: Mon, 23 Jul 2018 14:43:10 +0200 Subject: [PATCH 22/34] Remove outdated vendor information. (#7676) --- vendor/vendor.json | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/vendor/vendor.json b/vendor/vendor.json index 5221b45453f2..f34c0e276f3a 100644 --- a/vendor/vendor.json +++ b/vendor/vendor.json @@ -495,12 +495,6 @@ "version": "v0.0.4", "versionExact": "v0.0.4" }, - { - "path": "github.com/elastic/go-structform/internal/ubjson", - "revision": "v0.0.4", - "version": "v0.0.4", - "versionExact": "v0.0.4" - }, { "checksumSHA1": "s7k0vEuuqkoPXU0FtrD6Y0jxd7U=", "path": "github.com/elastic/go-structform/internal/unsafe", @@ -509,12 +503,6 @@ "version": "v0.0.4", "versionExact": "v0.0.4" }, - { - "path": "github.com/elastic/go-structform/internal/visitors", - "revision": "v0.0.4", - "version": "v0.0.4", - "versionExact": "v0.0.4" - }, { "checksumSHA1": "KTDpLMZRFtSVeUuXdaz5o5ehzfI=", "path": "github.com/elastic/go-structform/json", From e2ddff790e8cfc5691fbfd6d5b8e10d4268bd537 Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Mon, 23 Jul 2018 14:44:22 +0200 Subject: [PATCH 23/34] Fix Filebeat tests with new region_iso_code field (#7678) In https://github.com/elastic/elasticsearch/pull/31669 the field `region_iso_code` was added to the geoip processor. Because of this test broke with the most recent release of Elasticsearch as the events contain an undocumented field. --- filebeat/docs/fields.asciidoc | 70 +++++++++++++++++++ filebeat/include/fields.go | 2 +- .../module/apache2/access/_meta/fields.yml | 5 +- filebeat/module/auditd/log/_meta/fields.yml | 4 ++ .../startup/test/test.log-expected.json | 4 +- filebeat/module/iis/access/_meta/fields.yml | 4 ++ .../iis/access/test/test.log-expected.json | 2 + filebeat/module/iis/error/_meta/fields.yml | 4 ++ .../iis/error/test/test.log-expected.json | 3 + .../test/state-change-1.1.0.log-expected.json | 22 +++--- filebeat/module/nginx/access/_meta/fields.yml | 5 +- .../nginx/access/test/test.log-expected.json | 3 + filebeat/module/system/auth/_meta/fields.yml | 5 +- .../system/auth/test/test.log-expected.json | 1 + .../module/traefik/access/_meta/fields.yml | 4 ++ .../access/test/test.log-expected.json | 1 + testing/environments/args.yml | 2 +- 17 files changed, 123 insertions(+), 18 deletions(-) diff --git a/filebeat/docs/fields.asciidoc b/filebeat/docs/fields.asciidoc index 615b55be10fb..62389c539b31 100644 --- a/filebeat/docs/fields.asciidoc +++ b/filebeat/docs/fields.asciidoc @@ -305,6 +305,16 @@ type: keyword The city name. +-- + +*`apache2.access.geoip.region_iso_code`*:: ++ +-- +type: keyword + +Region ISO code. + + -- [float] @@ -556,6 +566,16 @@ type: geo_point The longitude and latitude. +-- + +*`auditd.log.geoip.region_iso_code`*:: ++ +-- +type: keyword + +Region ISO code. + + -- [[exported-fields-beat]] @@ -2000,6 +2020,16 @@ type: keyword The city name. +-- + +*`iis.access.geoip.region_iso_code`*:: ++ +-- +type: keyword + +Region ISO code. + + -- [float] @@ -2166,6 +2196,16 @@ type: keyword The city name. +-- + +*`iis.error.geoip.region_iso_code`*:: ++ +-- +type: keyword + +Region ISO code. + + -- [[exported-fields-kafka]] @@ -3353,6 +3393,16 @@ type: keyword The city name. +-- + +*`nginx.access.geoip.region_iso_code`*:: ++ +-- +type: keyword + +Region ISO code. + + -- [float] @@ -3890,6 +3940,16 @@ type: geo_point The longitude and latitude. +-- + +*`system.auth.ssh.geoip.region_iso_code`*:: ++ +-- +type: keyword + +Region ISO code. + + -- [float] @@ -4333,6 +4393,16 @@ type: keyword The city name. +-- + +*`traefik.access.geoip.region_iso_code`*:: ++ +-- +type: keyword + +Region ISO code. + + -- *`traefik.access.request_count`*:: diff --git a/filebeat/include/fields.go b/filebeat/include/fields.go index 50090ec4e8d1..b8576ce4a90a 100644 --- a/filebeat/include/fields.go +++ b/filebeat/include/fields.go @@ -31,5 +31,5 @@ func init() { // Asset returns asset data func Asset() string { - return "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" + return "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" } diff --git a/filebeat/module/apache2/access/_meta/fields.yml b/filebeat/module/apache2/access/_meta/fields.yml index be09717198ce..c73354f629e2 100644 --- a/filebeat/module/apache2/access/_meta/fields.yml +++ b/filebeat/module/apache2/access/_meta/fields.yml @@ -112,4 +112,7 @@ type: keyword description: > The city name. - + - name: region_iso_code + type: keyword + description: > + Region ISO code. diff --git a/filebeat/module/auditd/log/_meta/fields.yml b/filebeat/module/auditd/log/_meta/fields.yml index 9fff5ca6a7de..55607c9fa44f 100644 --- a/filebeat/module/auditd/log/_meta/fields.yml +++ b/filebeat/module/auditd/log/_meta/fields.yml @@ -77,3 +77,7 @@ type: geo_point description: > The longitude and latitude. + - name: region_iso_code + type: keyword + description: > + Region ISO code. diff --git a/filebeat/module/icinga/startup/test/test.log-expected.json b/filebeat/module/icinga/startup/test/test.log-expected.json index bfbe2f0d06a3..2f8cd6198c4e 100644 --- a/filebeat/module/icinga/startup/test/test.log-expected.json +++ b/filebeat/module/icinga/startup/test/test.log-expected.json @@ -1,6 +1,6 @@ [ { - "@timestamp": "2018-06-27T06:22:36.186Z", + "@timestamp": "2018-07-23T11:50:38.896Z", "fileset.module": "icinga", "fileset.name": "startup", "icinga.startup.facility": "cli", @@ -11,7 +11,7 @@ "prospector.type": "log" }, { - "@timestamp": "2018-06-27T06:22:36.186Z", + "@timestamp": "2018-07-23T11:50:38.896Z", "fileset.module": "icinga", "fileset.name": "startup", "icinga.startup.facility": "cli", diff --git a/filebeat/module/iis/access/_meta/fields.yml b/filebeat/module/iis/access/_meta/fields.yml index c38779f11b73..0a8181fe2589 100644 --- a/filebeat/module/iis/access/_meta/fields.yml +++ b/filebeat/module/iis/access/_meta/fields.yml @@ -157,3 +157,7 @@ type: keyword description: > The city name. + - name: region_iso_code + type: keyword + description: > + Region ISO code. diff --git a/filebeat/module/iis/access/test/test.log-expected.json b/filebeat/module/iis/access/test/test.log-expected.json index 7544fbbb01d5..78adf0ee379b 100644 --- a/filebeat/module/iis/access/test/test.log-expected.json +++ b/filebeat/module/iis/access/test/test.log-expected.json @@ -8,6 +8,7 @@ "iis.access.geoip.country_iso_code": "DE", "iis.access.geoip.location.lat": 52.5167, "iis.access.geoip.location.lon": 13.4, + "iis.access.geoip.region_iso_code": "DE-BE", "iis.access.geoip.region_name": "Land Berlin", "iis.access.method": "GET", "iis.access.port": "80", @@ -73,6 +74,7 @@ "iis.access.geoip.country_iso_code": "DE", "iis.access.geoip.location.lat": 52.5167, "iis.access.geoip.location.lon": 13.4, + "iis.access.geoip.region_iso_code": "DE-BE", "iis.access.geoip.region_name": "Land Berlin", "iis.access.hostname": "example.com", "iis.access.http_version": "1.1", diff --git a/filebeat/module/iis/error/_meta/fields.yml b/filebeat/module/iis/error/_meta/fields.yml index ff48d7407b73..90ff367b836a 100644 --- a/filebeat/module/iis/error/_meta/fields.yml +++ b/filebeat/module/iis/error/_meta/fields.yml @@ -71,3 +71,7 @@ type: keyword description: > The city name. + - name: region_iso_code + type: keyword + description: > + Region ISO code. diff --git a/filebeat/module/iis/error/test/test.log-expected.json b/filebeat/module/iis/error/test/test.log-expected.json index 2730859e55b2..e565e78cd7bc 100644 --- a/filebeat/module/iis/error/test/test.log-expected.json +++ b/filebeat/module/iis/error/test/test.log-expected.json @@ -26,6 +26,7 @@ "iis.error.geoip.country_iso_code": "DE", "iis.error.geoip.location.lat": 52.5167, "iis.error.geoip.location.lon": 13.4, + "iis.error.geoip.region_iso_code": "DE-BE", "iis.error.geoip.region_name": "Land Berlin", "iis.error.http_version": "1.1", "iis.error.method": "GET", @@ -50,6 +51,7 @@ "iis.error.geoip.country_iso_code": "DE", "iis.error.geoip.location.lat": 52.5167, "iis.error.geoip.location.lon": 13.4, + "iis.error.geoip.region_iso_code": "DE-BE", "iis.error.geoip.region_name": "Land Berlin", "iis.error.http_version": "2.0", "iis.error.method": "GET", @@ -74,6 +76,7 @@ "iis.error.geoip.country_iso_code": "DE", "iis.error.geoip.location.lat": 52.5167, "iis.error.geoip.location.lon": 13.4, + "iis.error.geoip.region_iso_code": "DE-BE", "iis.error.geoip.region_name": "Land Berlin", "iis.error.queue_name": "-", "iis.error.reason_phrase": "Timer_MinBytesPerSecond", diff --git a/filebeat/module/kafka/log/test/state-change-1.1.0.log-expected.json b/filebeat/module/kafka/log/test/state-change-1.1.0.log-expected.json index 263ec3871dd2..be011b17d237 100644 --- a/filebeat/module/kafka/log/test/state-change-1.1.0.log-expected.json +++ b/filebeat/module/kafka/log/test/state-change-1.1.0.log-expected.json @@ -1,15 +1,15 @@ [ { - "@timestamp": "2018-07-16T10:17:06.489Z", - "fileset.name": "log", - "fileset.module": "kafka", - "kafka.log.message": "Cached leader info PartitionState(controllerEpoch=25, leader=-1, leaderEpoch=15, isr=[10], zkVersion=15, replicas=[10], offlineReplicas=[10]) for partition __consumer_offsets-16 in response to UpdateMetadata request sent by controller 20 epoch 25 with correlation id 8", - "kafka.log.component": "Broker id=30", - "kafka.log.class": "state.change.logger", - "kafka.log.level": "TRACE", - "message": "[2018-07-16 10:17:06,489] TRACE [Broker id=30] Cached leader info PartitionState(controllerEpoch=25, leader=-1, leaderEpoch=15, isr=[10], zkVersion=15, replicas=[10], offlineReplicas=[10]) for partition __consumer_offsets-16 in response to UpdateMetadata request sent by controller 20 epoch 25 with correlation id 8 (state.change.logger)", - "offset": 0, - "input.type": "log", + "@timestamp": "2018-07-16T10:17:06.489Z", + "fileset.module": "kafka", + "fileset.name": "log", + "input.type": "log", + "kafka.log.class": "state.change.logger", + "kafka.log.component": "Broker id=30", + "kafka.log.level": "TRACE", + "kafka.log.message": "Cached leader info PartitionState(controllerEpoch=25, leader=-1, leaderEpoch=15, isr=[10], zkVersion=15, replicas=[10], offlineReplicas=[10]) for partition __consumer_offsets-16 in response to UpdateMetadata request sent by controller 20 epoch 25 with correlation id 8", + "message": "[2018-07-16 10:17:06,489] TRACE [Broker id=30] Cached leader info PartitionState(controllerEpoch=25, leader=-1, leaderEpoch=15, isr=[10], zkVersion=15, replicas=[10], offlineReplicas=[10]) for partition __consumer_offsets-16 in response to UpdateMetadata request sent by controller 20 epoch 25 with correlation id 8 (state.change.logger)", + "offset": 0, "prospector.type": "log" } -] +] \ No newline at end of file diff --git a/filebeat/module/nginx/access/_meta/fields.yml b/filebeat/module/nginx/access/_meta/fields.yml index 38e89be9ddb2..a3ea4de961c0 100644 --- a/filebeat/module/nginx/access/_meta/fields.yml +++ b/filebeat/module/nginx/access/_meta/fields.yml @@ -119,4 +119,7 @@ type: keyword description: > The city name. - + - name: region_iso_code + type: keyword + description: > + Region ISO code. diff --git a/filebeat/module/nginx/access/test/test.log-expected.json b/filebeat/module/nginx/access/test/test.log-expected.json index 1d8b69e5c70b..d169272c44fc 100644 --- a/filebeat/module/nginx/access/test/test.log-expected.json +++ b/filebeat/module/nginx/access/test/test.log-expected.json @@ -65,6 +65,7 @@ "nginx.access.geoip.country_iso_code": "DE", "nginx.access.geoip.location.lat": 52.5167, "nginx.access.geoip.location.lon": 13.4, + "nginx.access.geoip.region_iso_code": "DE-BE", "nginx.access.geoip.region_name": "Land Berlin", "nginx.access.http_version": "1.1", "nginx.access.method": "GET", @@ -100,6 +101,7 @@ "nginx.access.geoip.country_iso_code": "DE", "nginx.access.geoip.location.lat": 52.5167, "nginx.access.geoip.location.lon": 13.4, + "nginx.access.geoip.region_iso_code": "DE-BE", "nginx.access.geoip.region_name": "Land Berlin", "nginx.access.http_version": "1.1", "nginx.access.method": "GET", @@ -133,6 +135,7 @@ "nginx.access.geoip.country_iso_code": "US", "nginx.access.geoip.location.lat": 39.772, "nginx.access.geoip.location.lon": -89.6859, + "nginx.access.geoip.region_iso_code": "US-IL", "nginx.access.geoip.region_name": "Illinois", "nginx.access.http_version": "1.1", "nginx.access.method": "GET", diff --git a/filebeat/module/system/auth/_meta/fields.yml b/filebeat/module/system/auth/_meta/fields.yml index 1e94e3dfe08c..92fe1689e29f 100644 --- a/filebeat/module/system/auth/_meta/fields.yml +++ b/filebeat/module/system/auth/_meta/fields.yml @@ -79,7 +79,10 @@ type: geo_point description: > The longitude and latitude. - + - name: region_iso_code + type: keyword + description: > + Region ISO code. - name: sudo type: group description: > diff --git a/filebeat/module/system/auth/test/test.log-expected.json b/filebeat/module/system/auth/test/test.log-expected.json index 276558f363ac..93e792d5a2a4 100644 --- a/filebeat/module/system/auth/test/test.log-expected.json +++ b/filebeat/module/system/auth/test/test.log-expected.json @@ -61,6 +61,7 @@ "system.auth.ssh.geoip.country_iso_code": "CN", "system.auth.ssh.geoip.location.lat": 22.5333, "system.auth.ssh.geoip.location.lon": 114.1333, + "system.auth.ssh.geoip.region_iso_code": "CN-44", "system.auth.ssh.geoip.region_name": "Guangdong", "system.auth.ssh.ip": "116.31.116.24", "system.auth.ssh.method": "password", diff --git a/filebeat/module/traefik/access/_meta/fields.yml b/filebeat/module/traefik/access/_meta/fields.yml index 01250f8f7065..f205f72a80da 100644 --- a/filebeat/module/traefik/access/_meta/fields.yml +++ b/filebeat/module/traefik/access/_meta/fields.yml @@ -112,6 +112,10 @@ type: keyword description: > The city name. + - name: region_iso_code + type: keyword + description: > + Region ISO code. - name: request_count type: long description: > diff --git a/filebeat/module/traefik/access/test/test.log-expected.json b/filebeat/module/traefik/access/test/test.log-expected.json index d75a0d93a44b..623a948a340f 100644 --- a/filebeat/module/traefik/access/test/test.log-expected.json +++ b/filebeat/module/traefik/access/test/test.log-expected.json @@ -35,6 +35,7 @@ "traefik.access.geoip.country_iso_code": "DE", "traefik.access.geoip.location.lat": 52.5167, "traefik.access.geoip.location.lon": 13.4, + "traefik.access.geoip.region_iso_code": "DE-BE", "traefik.access.geoip.region_name": "Land Berlin", "traefik.access.http_version": "1.1", "traefik.access.method": "GET", diff --git a/testing/environments/args.yml b/testing/environments/args.yml index db44bdda79be..033b0db0bacf 100644 --- a/testing/environments/args.yml +++ b/testing/environments/args.yml @@ -7,4 +7,4 @@ services: args: DOWNLOAD_URL: https://snapshots.elastic.co/downloads ELASTIC_VERSION: 7.0.0-alpha1-SNAPSHOT - CACHE_BUST: 20180501 + CACHE_BUST: 20180723 From ff45ef8e05e6fc7e51125079a77b6eb9c36e92f6 Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Mon, 23 Jul 2018 15:46:33 +0200 Subject: [PATCH 24/34] Fix duplicated module headers (#7650) * Fix duplicated module headers Closes https://github.com/elastic/beats/issues/7643 * fix metricset titles for munin and kvm * fix imssing kubernetes apiserver metricset doc * remove headers from modules / metricset generator and clean up traefik title --- metricbeat/docs/modules/kubernetes.asciidoc | 4 ++++ .../docs/modules/kubernetes/apiserver.asciidoc | 17 +++++++++++++++++ metricbeat/docs/modules/kvm.asciidoc | 2 -- metricbeat/docs/modules/munin.asciidoc | 2 -- metricbeat/docs/modules/uwsgi.asciidoc | 2 -- metricbeat/docs/modules_list.asciidoc | 3 ++- .../kubernetes/apiserver/_meta/docs.asciidoc | 1 + metricbeat/module/kvm/_meta/docs.asciidoc | 2 -- .../module/kvm/dommemstat/_meta/docs.asciidoc | 2 -- metricbeat/module/munin/_meta/docs.asciidoc | 2 -- .../module/munin/node/_meta/docs.asciidoc | 2 -- .../module/traefik/health/_meta/docs.asciidoc | 2 -- metricbeat/module/uwsgi/_meta/docs.asciidoc | 2 -- metricbeat/scripts/module/docs.asciidoc | 2 -- .../scripts/module/metricset/docs.asciidoc | 2 -- 15 files changed, 24 insertions(+), 23 deletions(-) create mode 100644 metricbeat/docs/modules/kubernetes/apiserver.asciidoc create mode 100644 metricbeat/module/kubernetes/apiserver/_meta/docs.asciidoc diff --git a/metricbeat/docs/modules/kubernetes.asciidoc b/metricbeat/docs/modules/kubernetes.asciidoc index e4ad44911099..d2398036c8db 100644 --- a/metricbeat/docs/modules/kubernetes.asciidoc +++ b/metricbeat/docs/modules/kubernetes.asciidoc @@ -89,6 +89,8 @@ This module supports TLS connection when using `ssl` config field, as described The following metricsets are available: +* <> + * <> * <> @@ -113,6 +115,8 @@ The following metricsets are available: * <> +include::kubernetes/apiserver.asciidoc[] + include::kubernetes/container.asciidoc[] include::kubernetes/event.asciidoc[] diff --git a/metricbeat/docs/modules/kubernetes/apiserver.asciidoc b/metricbeat/docs/modules/kubernetes/apiserver.asciidoc new file mode 100644 index 000000000000..f32fa961bdd9 --- /dev/null +++ b/metricbeat/docs/modules/kubernetes/apiserver.asciidoc @@ -0,0 +1,17 @@ +//// +This file is generated! See scripts/docs_collector.py +//// + +[[metricbeat-metricset-kubernetes-apiserver]] +=== Kubernetes apiserver metricset + +beta[] + +include::../../../module/kubernetes/apiserver/_meta/docs.asciidoc[] + + +==== Fields + +For a description of each field in the metricset, see the +<> section. + diff --git a/metricbeat/docs/modules/kvm.asciidoc b/metricbeat/docs/modules/kvm.asciidoc index 0aec7ec7ab4d..b5acf8877dc9 100644 --- a/metricbeat/docs/modules/kvm.asciidoc +++ b/metricbeat/docs/modules/kvm.asciidoc @@ -7,8 +7,6 @@ This file is generated! See scripts/docs_collector.py experimental[] -== kvm module - This is the kvm module. diff --git a/metricbeat/docs/modules/munin.asciidoc b/metricbeat/docs/modules/munin.asciidoc index 517211e06823..0622fe3405f7 100644 --- a/metricbeat/docs/modules/munin.asciidoc +++ b/metricbeat/docs/modules/munin.asciidoc @@ -7,8 +7,6 @@ This file is generated! See scripts/docs_collector.py experimental[] -== munin module - This is the munin module. The default metricset is `node`. diff --git a/metricbeat/docs/modules/uwsgi.asciidoc b/metricbeat/docs/modules/uwsgi.asciidoc index bb8df6c8582d..2f102716b838 100644 --- a/metricbeat/docs/modules/uwsgi.asciidoc +++ b/metricbeat/docs/modules/uwsgi.asciidoc @@ -7,8 +7,6 @@ This file is generated! See scripts/docs_collector.py beta[] -== uwsgi module - This is the uwsgi module. By default collects the `stats` metricset, using http://uwsgi-docs.readthedocs.io/en/latest/StatsServer.html[StatsServer]. diff --git a/metricbeat/docs/modules_list.asciidoc b/metricbeat/docs/modules_list.asciidoc index 94a0d06d86f5..d70f4b00484d 100644 --- a/metricbeat/docs/modules_list.asciidoc +++ b/metricbeat/docs/modules_list.asciidoc @@ -65,7 +65,8 @@ This file is generated! See scripts/docs_collector.py .2+| .2+| |<> beta[] |<> beta[] |<> |image:./images/icon-yes.png[Prebuilt dashboards are available] | -.12+| .12+| |<> +.13+| .13+| |<> beta[] +|<> |<> beta[] |<> |<> diff --git a/metricbeat/module/kubernetes/apiserver/_meta/docs.asciidoc b/metricbeat/module/kubernetes/apiserver/_meta/docs.asciidoc new file mode 100644 index 000000000000..bc9e31737a4c --- /dev/null +++ b/metricbeat/module/kubernetes/apiserver/_meta/docs.asciidoc @@ -0,0 +1 @@ +This is the `apiserver` metricset of the Kubernetes module. diff --git a/metricbeat/module/kvm/_meta/docs.asciidoc b/metricbeat/module/kvm/_meta/docs.asciidoc index b4d11cbf9f0b..99141215f113 100644 --- a/metricbeat/module/kvm/_meta/docs.asciidoc +++ b/metricbeat/module/kvm/_meta/docs.asciidoc @@ -1,4 +1,2 @@ -== kvm module - This is the kvm module. diff --git a/metricbeat/module/kvm/dommemstat/_meta/docs.asciidoc b/metricbeat/module/kvm/dommemstat/_meta/docs.asciidoc index 9b34db197ddb..89e2dfff5d96 100644 --- a/metricbeat/module/kvm/dommemstat/_meta/docs.asciidoc +++ b/metricbeat/module/kvm/dommemstat/_meta/docs.asciidoc @@ -1,3 +1 @@ -=== kvm dommemstat MetricSet - This is the dommemstat metricset of the module kvm. diff --git a/metricbeat/module/munin/_meta/docs.asciidoc b/metricbeat/module/munin/_meta/docs.asciidoc index d7e009b4c28f..d4148381d2eb 100644 --- a/metricbeat/module/munin/_meta/docs.asciidoc +++ b/metricbeat/module/munin/_meta/docs.asciidoc @@ -1,5 +1,3 @@ -== munin module - This is the munin module. The default metricset is `node`. diff --git a/metricbeat/module/munin/node/_meta/docs.asciidoc b/metricbeat/module/munin/node/_meta/docs.asciidoc index a20a538c7462..403f5fa93b9f 100644 --- a/metricbeat/module/munin/node/_meta/docs.asciidoc +++ b/metricbeat/module/munin/node/_meta/docs.asciidoc @@ -1,5 +1,3 @@ -=== munin node MetricSet - This is the node metricset of the module munin. [float] diff --git a/metricbeat/module/traefik/health/_meta/docs.asciidoc b/metricbeat/module/traefik/health/_meta/docs.asciidoc index e94ed71f3fb5..2a1cace18646 100644 --- a/metricbeat/module/traefik/health/_meta/docs.asciidoc +++ b/metricbeat/module/traefik/health/_meta/docs.asciidoc @@ -1,3 +1 @@ -=== traefik health MetricSet - This is the health metricset of the module traefik. diff --git a/metricbeat/module/uwsgi/_meta/docs.asciidoc b/metricbeat/module/uwsgi/_meta/docs.asciidoc index af53032206ee..89c89dc533a1 100644 --- a/metricbeat/module/uwsgi/_meta/docs.asciidoc +++ b/metricbeat/module/uwsgi/_meta/docs.asciidoc @@ -1,5 +1,3 @@ -== uwsgi module - This is the uwsgi module. By default collects the `stats` metricset, using http://uwsgi-docs.readthedocs.io/en/latest/StatsServer.html[StatsServer]. diff --git a/metricbeat/scripts/module/docs.asciidoc b/metricbeat/scripts/module/docs.asciidoc index 3447dd2758a9..447c150bb222 100644 --- a/metricbeat/scripts/module/docs.asciidoc +++ b/metricbeat/scripts/module/docs.asciidoc @@ -1,4 +1,2 @@ -== {module} module - This is the {module} module. diff --git a/metricbeat/scripts/module/metricset/docs.asciidoc b/metricbeat/scripts/module/metricset/docs.asciidoc index 1334c28ab761..9be9dece382a 100644 --- a/metricbeat/scripts/module/metricset/docs.asciidoc +++ b/metricbeat/scripts/module/metricset/docs.asciidoc @@ -1,3 +1 @@ -=== {module} {metricset} MetricSet - This is the {metricset} metricset of the module {module}. From 9db7866f370ac84799876b0248ce608f04f695bf Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Mon, 23 Jul 2018 21:02:18 +0200 Subject: [PATCH 25/34] Release munin and traefik module as beta. (#7660) * Release munin and treafik module as beta. * fixes to munin module --- CHANGELOG.asciidoc | 1 + metricbeat/docs/fields.asciidoc | 1 - metricbeat/docs/modules/munin.asciidoc | 2 +- metricbeat/docs/modules/munin/node.asciidoc | 2 +- metricbeat/docs/modules/traefik.asciidoc | 2 +- metricbeat/docs/modules_list.asciidoc | 6 +++--- metricbeat/module/munin/_meta/fields.yml | 4 +--- metricbeat/module/munin/fields.go | 2 +- metricbeat/module/munin/node/_meta/fields.yml | 2 +- metricbeat/module/munin/node/node.go | 2 +- metricbeat/module/traefik/_meta/fields.yml | 1 + metricbeat/module/traefik/fields.go | 2 +- metricbeat/module/traefik/health/health.go | 2 +- 13 files changed, 14 insertions(+), 15 deletions(-) diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index dfef2b349e0f..629227d41157 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -314,6 +314,7 @@ https://github.com/elastic/beats/compare/v6.2.3...master[Check the HEAD diff] - Run Kafka integration tests on version 1.1.0 {pull}7616[7616] - Release raid and socket metricset from system module as GA. {pull}7658[7658] - Release elasticsearch module and all its metricsets as beta. {pull}7662[7662] +- Release munin and traefik module as beta. {pull}7660[7660] *Packetbeat* diff --git a/metricbeat/docs/fields.asciidoc b/metricbeat/docs/fields.asciidoc index 15c365785fcf..650e2073ad64 100644 --- a/metricbeat/docs/fields.asciidoc +++ b/metricbeat/docs/fields.asciidoc @@ -11066,7 +11066,6 @@ The amount of time spent for commits that occurred while a write lock was held. [[exported-fields-munin]] == Munin fields -experimental[] Munin node metrics exporter diff --git a/metricbeat/docs/modules/munin.asciidoc b/metricbeat/docs/modules/munin.asciidoc index 0622fe3405f7..08fd4fb272ad 100644 --- a/metricbeat/docs/modules/munin.asciidoc +++ b/metricbeat/docs/modules/munin.asciidoc @@ -5,7 +5,7 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-module-munin]] == Munin module -experimental[] +beta[] This is the munin module. diff --git a/metricbeat/docs/modules/munin/node.asciidoc b/metricbeat/docs/modules/munin/node.asciidoc index 9e40635bd3f3..a485a6a730ef 100644 --- a/metricbeat/docs/modules/munin/node.asciidoc +++ b/metricbeat/docs/modules/munin/node.asciidoc @@ -5,7 +5,7 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-metricset-munin-node]] === Munin node metricset -experimental[] +beta[] include::../../../module/munin/node/_meta/docs.asciidoc[] diff --git a/metricbeat/docs/modules/traefik.asciidoc b/metricbeat/docs/modules/traefik.asciidoc index 0dfaa5d9759c..1082690d5cfd 100644 --- a/metricbeat/docs/modules/traefik.asciidoc +++ b/metricbeat/docs/modules/traefik.asciidoc @@ -5,7 +5,7 @@ This file is generated! See scripts/docs_collector.py [[metricbeat-module-traefik]] == traefik module -experimental[] +beta[] This module periodically fetches metrics from a https://traefik.io/[Traefik] instance. The Traefik instance must be configured to expose it's HTTP API. diff --git a/metricbeat/docs/modules_list.asciidoc b/metricbeat/docs/modules_list.asciidoc index d70f4b00484d..cf7d64acb3d4 100644 --- a/metricbeat/docs/modules_list.asciidoc +++ b/metricbeat/docs/modules_list.asciidoc @@ -89,8 +89,8 @@ This file is generated! See scripts/docs_collector.py .3+| .3+| |<> |<> |<> -|<> experimental[] |image:./images/icon-no.png[No prebuilt dashboards] | -.1+| .1+| |<> experimental[] +|<> beta[] |image:./images/icon-no.png[No prebuilt dashboards] | +.1+| .1+| |<> beta[] |<> |image:./images/icon-yes.png[Prebuilt dashboards are available] | .2+| .2+| |<> experimental[] |<> @@ -128,7 +128,7 @@ This file is generated! See scripts/docs_collector.py |<> |<> |<> -|<> experimental[] |image:./images/icon-no.png[No prebuilt dashboards] | +|<> beta[] |image:./images/icon-no.png[No prebuilt dashboards] | .1+| .1+| |<> experimental[] |<> beta[] |image:./images/icon-yes.png[Prebuilt dashboards are available] | .1+| .1+| |<> beta[] diff --git a/metricbeat/module/munin/_meta/fields.yml b/metricbeat/module/munin/_meta/fields.yml index 35912fe1a718..83e41a59fa94 100644 --- a/metricbeat/module/munin/_meta/fields.yml +++ b/metricbeat/module/munin/_meta/fields.yml @@ -1,10 +1,8 @@ - key: munin title: "Munin" description: > - experimental[] - Munin node metrics exporter - release: experimental + release: beta fields: - name: munin type: group diff --git a/metricbeat/module/munin/fields.go b/metricbeat/module/munin/fields.go index 3127d2e8870c..eb4ba9840392 100644 --- a/metricbeat/module/munin/fields.go +++ b/metricbeat/module/munin/fields.go @@ -31,5 +31,5 @@ func init() { // Asset returns asset data func Asset() string { - return "eJxszkFqxiAUBOC9pxiyzwVc9AY9QenCxml4VJ+iL9DcvsQE+gfydg4z8s344e6RNxV1gIklekzvx3tyQGRfmlSToh5vDgD4W9kkUy2kj083stGHlkhkWpOlH7XSjM0BjYmh09+mDvgWptj9+GGGhsx/yXG2V3qsrWz1Sh44540ZlqIWRPsN0RnxtSNcnYEMK9Wu+avilDx7/wIAAP//QeFdrA==" + return "eJxsjk2qhDAQhPc5ReHeC2TxbvAOEU2NNKOdkLQw3n4wBmaEqV3/FN834snDY9tV1AEmttJj+D/nwQGRdS6STZJ6/DkAaDdoisRGKzJX8JVTMRYHFK4MlR4TLTjgIVxj9a05QsPGD+2MHZkeS0l77psfyCuthjmpBdF6g1dGTAdC/2lyYaFar39bXCZ3z3cAAAD//xiKUG4=" } diff --git a/metricbeat/module/munin/node/_meta/fields.yml b/metricbeat/module/munin/node/_meta/fields.yml index dd5e036bb81e..8033a27f5ac5 100644 --- a/metricbeat/module/munin/node/_meta/fields.yml +++ b/metricbeat/module/munin/node/_meta/fields.yml @@ -1 +1 @@ -- release: experimental +- release: beta diff --git a/metricbeat/module/munin/node/node.go b/metricbeat/module/munin/node/node.go index 752a972c9902..9fe283db0f07 100644 --- a/metricbeat/module/munin/node/node.go +++ b/metricbeat/module/munin/node/node.go @@ -49,7 +49,7 @@ type MetricSet struct { // New creates a new instance of the MetricSet. New is responsible for unpacking // any MetricSet specific configuration options if there are any. func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Experimental("The munin node metricset is experimental.") + cfgwarn.Beta("The munin node metricset is beta.") config := struct { Namespace string `config:"node.namespace" validate:"required"` diff --git a/metricbeat/module/traefik/_meta/fields.yml b/metricbeat/module/traefik/_meta/fields.yml index 80e38036c79f..6d59279d47cd 100644 --- a/metricbeat/module/traefik/_meta/fields.yml +++ b/metricbeat/module/traefik/_meta/fields.yml @@ -2,6 +2,7 @@ title: "traefik" description: > Traefik reverse proxy / load balancer metrics + release: beta fields: - name: traefik type: group diff --git a/metricbeat/module/traefik/fields.go b/metricbeat/module/traefik/fields.go index 6412dba7df36..db74b6b530ea 100644 --- a/metricbeat/module/traefik/fields.go +++ b/metricbeat/module/traefik/fields.go @@ -31,5 +31,5 @@ func init() { // Asset returns asset data func Asset() string { - return "eJy00TFP8zAQBuA9v+JVl2/qx54BqSMDCCGYK8e+pKaJzzo7Ff33yGnauiEqFYgbfbHvyXtLbGlfIoqi2m4LINrYUonFeLIoAENBi/XRsitxXwDA66ELoR1JIHjhjz3u0LIyqFSrnCZBR1GsDgVQW2pNKIe7SzjVUT4zVdx7KtEI9348mRn7k9Gp8vE5YUOqjZvT8ZziiiTV42EOuIrKOjKohbuj8V8YJ2D1/AByxrN1Mbs/deW23kfb0f9A+qJ9NLbsmknjCjPV2/AguD5FaF2IKS5Yh0CanQmzFKHg2QWahUzDukHyMr432dK1VHKO5v4ixW+DuYGU6qnvKpIU0PGHp7KzQe2a9bCf/us3v5esdiSqoZMDw+asQ2e18NyqcluIKvZhrdlMN3a2cfVOei7EQ2P9B1nCk4w2DLbPAAAA///IQi90" + return "eJy00TGP2kAQBeDev+KJJhVJ7yISZYpEUZSr0Xr9bPawd1aza3T8+5ONAeOzOHSnm3IHZj6/WWPPY46khpXbZ0ByqWGO1fiyyoCS0aoLyYnP8TMDgP+nLpQHaiSCyssRP9CIKVGYxnhLRcukzsYMUDY0kTkKJpMBlWNTxnyYtYY3LaeGvtIxMEet0oXxZYHxEUpf0/VTwo6mSbvL85LijqSv36c9kCIZ51miUmnPxm9x3IDN31+gL4M4nyb/n7umti4k1/J7pL1pn42N+HrWuMPs62kYCKkuETofUx8XnEekFV/GRYoyBvGRi5B5WA9I/o3zZle6l8qUY6W7SfHdYB4g9fWnawtqH9D5g+eyq8Ec6u1wn+7tbz4v2RyopubFgeFyzqN1VmXpVFNbTCZ1cWulnF/sapPimXYpxFNj+wVZIlBHGwbbawAAAP//CW40lQ==" } diff --git a/metricbeat/module/traefik/health/health.go b/metricbeat/module/traefik/health/health.go index 1bd1d7b89f62..a9c58c1d539c 100644 --- a/metricbeat/module/traefik/health/health.go +++ b/metricbeat/module/traefik/health/health.go @@ -51,7 +51,7 @@ type MetricSet struct { // New creates a new instance of the MetricSet. func New(base mb.BaseMetricSet) (mb.MetricSet, error) { - cfgwarn.Experimental("The traefik health metricset is experimental.") + cfgwarn.Beta("The traefik health metricset is beta.") http, err := helper.NewHTTP(base) if err != nil { return nil, err From 425828afc2a5c51bfa05afa3baf3446ac0c4716b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Carlos=20P=C3=A9rez-Aradros=20Herce?= Date: Mon, 23 Jul 2018 23:12:03 +0200 Subject: [PATCH 26/34] Report k8s pct metrics from enrichment process (#7677) Instead of doing it from the `state_container`. Problem with the previous approach is that `state_container` metricset is not run in all nodes, but from a single point. Making performance metrics not available in all cases. With this new approach, the enriching process will also collect performance metrics, so they should be available everywhere where the module is run. --- CHANGELOG.asciidoc | 1 + NOTICE.txt | 88 + metricbeat/module/kubernetes/_meta/config.yml | 2 - .../module/kubernetes/util/kubernetes.go | 38 +- metricbeat/modules.d/kubernetes.yml.disabled | 2 - .../vendor/github.com/gogo/protobuf/LICENSE | 36 + .../github.com/gogo/protobuf/proto/Makefile | 43 + .../github.com/gogo/protobuf/proto/clone.go | 258 ++ .../gogo/protobuf/proto/custom_gogo.go | 39 + .../github.com/gogo/protobuf/proto/decode.go | 428 +++ .../github.com/gogo/protobuf/proto/discard.go | 350 +++ .../gogo/protobuf/proto/duration.go | 100 + .../gogo/protobuf/proto/duration_gogo.go | 49 + .../github.com/gogo/protobuf/proto/encode.go | 221 ++ .../gogo/protobuf/proto/encode_gogo.go | 33 + .../github.com/gogo/protobuf/proto/equal.go | 300 ++ .../gogo/protobuf/proto/extensions.go | 604 ++++ .../gogo/protobuf/proto/extensions_gogo.go | 368 +++ .../github.com/gogo/protobuf/proto/lib.go | 921 ++++++ .../gogo/protobuf/proto/lib_gogo.go | 50 + .../gogo/protobuf/proto/message_set.go | 314 ++ .../gogo/protobuf/proto/pointer_reflect.go | 357 +++ .../protobuf/proto/pointer_reflect_gogo.go | 59 + .../gogo/protobuf/proto/pointer_unsafe.go | 308 ++ .../protobuf/proto/pointer_unsafe_gogo.go | 56 + .../gogo/protobuf/proto/properties.go | 600 ++++ .../gogo/protobuf/proto/properties_gogo.go | 36 + .../gogo/protobuf/proto/skip_gogo.go | 119 + .../gogo/protobuf/proto/table_marshal.go | 2799 +++++++++++++++++ .../gogo/protobuf/proto/table_marshal_gogo.go | 388 +++ .../gogo/protobuf/proto/table_merge.go | 657 ++++ .../gogo/protobuf/proto/table_unmarshal.go | 2048 ++++++++++++ .../protobuf/proto/table_unmarshal_gogo.go | 385 +++ .../github.com/gogo/protobuf/proto/text.go | 928 ++++++ .../gogo/protobuf/proto/text_gogo.go | 57 + .../gogo/protobuf/proto/text_parser.go | 998 ++++++ .../gogo/protobuf/proto/timestamp.go | 113 + .../gogo/protobuf/proto/timestamp_gogo.go | 49 + .../kubernetes/apimachinery/LICENSE | 202 ++ .../apimachinery/pkg/api/resource/OWNERS | 16 + .../apimachinery/pkg/api/resource/amount.go | 299 ++ .../pkg/api/resource/generated.pb.go | 77 + .../pkg/api/resource/generated.proto | 95 + .../apimachinery/pkg/api/resource/math.go | 314 ++ .../apimachinery/pkg/api/resource/quantity.go | 747 +++++ .../pkg/api/resource/quantity_proto.go | 284 ++ .../pkg/api/resource/scale_int.go | 95 + .../apimachinery/pkg/api/resource/suffix.go | 198 ++ .../pkg/api/resource/zz_generated.deepcopy.go | 27 + metricbeat/vendor/gopkg.in/inf.v0/LICENSE | 28 + metricbeat/vendor/gopkg.in/inf.v0/dec.go | 615 ++++ metricbeat/vendor/gopkg.in/inf.v0/rounder.go | 145 + metricbeat/vendor/vendor.json | 25 + 53 files changed, 17363 insertions(+), 6 deletions(-) create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/LICENSE create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/Makefile create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/clone.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/custom_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/decode.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/discard.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/duration.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/duration_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/encode.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/encode_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/equal.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/extensions.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/extensions_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/lib.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/lib_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/message_set.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_reflect.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_reflect_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_unsafe.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_unsafe_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/properties.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/properties_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/skip_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/table_marshal.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/table_marshal_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/table_merge.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/table_unmarshal.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/table_unmarshal_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/text.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/text_gogo.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/text_parser.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/timestamp.go create mode 100644 metricbeat/vendor/github.com/gogo/protobuf/proto/timestamp_gogo.go create mode 100644 metricbeat/vendor/github.com/kubernetes/apimachinery/LICENSE create mode 100755 metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/OWNERS create mode 100644 metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/amount.go create mode 100644 metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/generated.pb.go create mode 100644 metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/generated.proto create mode 100644 metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/math.go create mode 100644 metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/quantity.go create mode 100644 metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/quantity_proto.go create mode 100644 metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/scale_int.go create mode 100644 metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/suffix.go create mode 100644 metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/zz_generated.deepcopy.go create mode 100644 metricbeat/vendor/gopkg.in/inf.v0/LICENSE create mode 100644 metricbeat/vendor/gopkg.in/inf.v0/dec.go create mode 100644 metricbeat/vendor/gopkg.in/inf.v0/rounder.go diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index 629227d41157..ca9a0f508039 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -129,6 +129,7 @@ https://github.com/elastic/beats/compare/v6.2.3...master[Check the HEAD diff] - Fix Jolokia attribute mapping when using wildcards and MBean names with multiple properties. {pull}7321[7321] - Do not report Metricbeat container host as hostname in Kubernetes deployment. {issue}7199[7199] - Ensure metadata updates don't replace existing pod metrics. {pull}7573[7573] +- Fix kubernetes pct fields reporting. {pull}7677[7677] *Packetbeat* diff --git a/NOTICE.txt b/NOTICE.txt index e8a9677f0ec9..51c2164c2a64 100644 --- a/NOTICE.txt +++ b/NOTICE.txt @@ -1083,6 +1083,49 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. +-------------------------------------------------------------------- +Dependency: github.com/gogo/protobuf +Revision: 636bf0302bc95575d69441b25a2603156ffdddf1 +License type (autodetected): BSD-3-Clause +./metricbeat/vendor/github.com/gogo/protobuf/LICENSE: +-------------------------------------------------------------------- +Protocol Buffers for Go with Gadgets + +Copyright (c) 2013, The GoGo Authors. All rights reserved. +http://github.com/gogo/protobuf + +Go support for Protocol Buffers - Google's data interchange format + +Copyright 2010 The Go Authors. All rights reserved. +https://github.com/golang/protobuf + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + -------------------------------------------------------------------- Dependency: github.com/golang/protobuf Revision: 2bba0603135d7d7f5cb73b2125beeda19c09f4ef @@ -1380,6 +1423,16 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +-------------------------------------------------------------------- +Dependency: github.com/kubernetes/apimachinery +Version: kubernetes-1.11.1 +Revision: 103fd098999dc9c0c88536f5c9ad2e5da39373ae +License type (autodetected): Apache-2.0 +./metricbeat/vendor/github.com/kubernetes/apimachinery/LICENSE: +-------------------------------------------------------------------- +Apache License 2.0 + + -------------------------------------------------------------------- Dependency: github.com/lib/pq Revision: 2704adc878c21e1329f46f6e56a1c387d788ff94 @@ -2693,6 +2746,41 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +-------------------------------------------------------------------- +Dependency: gopkg.in/inf.v0 +Revision: d2d2541c53f18d2a059457998ce2876cc8e67cbf +License type (autodetected): BSD-3-Clause +./metricbeat/vendor/gopkg.in/inf.v0/LICENSE: +-------------------------------------------------------------------- +Copyright (c) 2012 Péter Surányi. Portions Copyright (c) 2009 The Go +Authors. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + -------------------------------------------------------------------- Dependency: gopkg.in/mgo.v2 Revision: 3f83fa5005286a7fe593b055f0d7771a7dce4655 diff --git a/metricbeat/module/kubernetes/_meta/config.yml b/metricbeat/module/kubernetes/_meta/config.yml index 1cbd85294612..82288c620122 100644 --- a/metricbeat/module/kubernetes/_meta/config.yml +++ b/metricbeat/module/kubernetes/_meta/config.yml @@ -7,8 +7,6 @@ # - container # - volume period: 10s - hosts: ["localhost:10255"] - hosts: ["localhost:10250"] bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token ssl.certificate_authorities: diff --git a/metricbeat/module/kubernetes/util/kubernetes.go b/metricbeat/module/kubernetes/util/kubernetes.go index 2a223a70c85c..43cbbc25f9a9 100644 --- a/metricbeat/module/kubernetes/util/kubernetes.go +++ b/metricbeat/module/kubernetes/util/kubernetes.go @@ -22,6 +22,8 @@ import ( "sync" "time" + "github.com/kubernetes/apimachinery/pkg/api/resource" + "github.com/elastic/beats/libbeat/common" "github.com/elastic/beats/libbeat/common/kubernetes" "github.com/elastic/beats/libbeat/logp" @@ -95,10 +97,10 @@ func GetWatcher(base mb.BaseMetricSet, resource kubernetes.Resource, nodeScope b // NewResourceMetadataEnricher returns an Enricher configured for kubernetes resource events func NewResourceMetadataEnricher( base mb.BaseMetricSet, - resource kubernetes.Resource, + res kubernetes.Resource, nodeScope bool) Enricher { - watcher, err := GetWatcher(base, resource, nodeScope) + watcher, err := GetWatcher(base, res, nodeScope) if err != nil { logp.Err("Error initializing Kubernetes metadata enricher: %s", err) return &nilEnricher{} @@ -123,6 +125,23 @@ func NewResourceMetadataEnricher( switch r := r.(type) { case *kubernetes.Pod: m[id] = metaGen.PodMetadata(r) + + case *kubernetes.Node: + // Report node allocatable resources to PerfMetrics cache + name := r.GetMetadata().GetName() + if cpu, ok := r.GetStatus().GetCapacity()["cpu"]; ok { + if q, err := resource.ParseQuantity(cpu.GetString_()); err == nil { + PerfMetrics.NodeCoresAllocatable.Set(name, float64(q.MilliValue())/1000) + } + } + if memory, ok := r.GetStatus().GetCapacity()["memory"]; ok { + if q, err := resource.ParseQuantity(memory.GetString_()); err == nil { + PerfMetrics.NodeMemAllocatable.Set(name, float64(q.Value())) + } + } + + m[id] = metaGen.ResourceMetadata(r) + default: m[id] = metaGen.ResourceMetadata(r) } @@ -169,7 +188,22 @@ func NewContainerMetadataEnricher( func(m map[string]common.MapStr, r kubernetes.Resource) { pod := r.(*kubernetes.Pod) meta := metaGen.PodMetadata(pod) + for _, container := range append(pod.GetSpec().GetContainers(), pod.GetSpec().GetInitContainers()...) { + cuid := ContainerUID(pod.GetMetadata().GetNamespace(), r.GetMetadata().GetName(), container.GetName()) + + // Report container limits to PerfMetrics cache + if cpu, ok := container.GetResources().GetLimits()["cpu"]; ok { + if q, err := resource.ParseQuantity(cpu.GetString_()); err == nil { + PerfMetrics.ContainerCoresLimit.Set(cuid, float64(q.MilliValue())/1000) + } + } + if memory, ok := container.GetResources().GetLimits()["memory"]; ok { + if q, err := resource.ParseQuantity(memory.GetString_()); err == nil { + PerfMetrics.ContainerMemLimit.Set(cuid, float64(q.Value())) + } + } + id := join(r.GetMetadata().GetNamespace(), r.GetMetadata().GetName(), container.GetName()) m[id] = meta } diff --git a/metricbeat/modules.d/kubernetes.yml.disabled b/metricbeat/modules.d/kubernetes.yml.disabled index 1d0746905429..94cb3a9960ea 100644 --- a/metricbeat/modules.d/kubernetes.yml.disabled +++ b/metricbeat/modules.d/kubernetes.yml.disabled @@ -10,8 +10,6 @@ # - container # - volume period: 10s - hosts: ["localhost:10255"] - hosts: ["localhost:10250"] bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token ssl.certificate_authorities: diff --git a/metricbeat/vendor/github.com/gogo/protobuf/LICENSE b/metricbeat/vendor/github.com/gogo/protobuf/LICENSE new file mode 100644 index 000000000000..7be0cc7b62cf --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/LICENSE @@ -0,0 +1,36 @@ +Protocol Buffers for Go with Gadgets + +Copyright (c) 2013, The GoGo Authors. All rights reserved. +http://github.com/gogo/protobuf + +Go support for Protocol Buffers - Google's data interchange format + +Copyright 2010 The Go Authors. All rights reserved. +https://github.com/golang/protobuf + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/Makefile b/metricbeat/vendor/github.com/gogo/protobuf/proto/Makefile new file mode 100644 index 000000000000..00d65f327732 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/Makefile @@ -0,0 +1,43 @@ +# Go support for Protocol Buffers - Google's data interchange format +# +# Copyright 2010 The Go Authors. All rights reserved. +# https://github.com/golang/protobuf +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions are +# met: +# +# * Redistributions of source code must retain the above copyright +# notice, this list of conditions and the following disclaimer. +# * Redistributions in binary form must reproduce the above +# copyright notice, this list of conditions and the following disclaimer +# in the documentation and/or other materials provided with the +# distribution. +# * Neither the name of Google Inc. nor the names of its +# contributors may be used to endorse or promote products derived from +# this software without specific prior written permission. +# +# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +# A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +# OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +# SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +# LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +# OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +install: + go install + +test: install generate-test-pbs + go test + + +generate-test-pbs: + make install + make -C test_proto + make -C proto3_proto + make diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/clone.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/clone.go new file mode 100644 index 000000000000..a26b046d94f1 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/clone.go @@ -0,0 +1,258 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2011 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// Protocol buffer deep copy and merge. +// TODO: RawMessage. + +package proto + +import ( + "fmt" + "log" + "reflect" + "strings" +) + +// Clone returns a deep copy of a protocol buffer. +func Clone(src Message) Message { + in := reflect.ValueOf(src) + if in.IsNil() { + return src + } + out := reflect.New(in.Type().Elem()) + dst := out.Interface().(Message) + Merge(dst, src) + return dst +} + +// Merger is the interface representing objects that can merge messages of the same type. +type Merger interface { + // Merge merges src into this message. + // Required and optional fields that are set in src will be set to that value in dst. + // Elements of repeated fields will be appended. + // + // Merge may panic if called with a different argument type than the receiver. + Merge(src Message) +} + +// generatedMerger is the custom merge method that generated protos will have. +// We must add this method since a generate Merge method will conflict with +// many existing protos that have a Merge data field already defined. +type generatedMerger interface { + XXX_Merge(src Message) +} + +// Merge merges src into dst. +// Required and optional fields that are set in src will be set to that value in dst. +// Elements of repeated fields will be appended. +// Merge panics if src and dst are not the same type, or if dst is nil. +func Merge(dst, src Message) { + if m, ok := dst.(Merger); ok { + m.Merge(src) + return + } + + in := reflect.ValueOf(src) + out := reflect.ValueOf(dst) + if out.IsNil() { + panic("proto: nil destination") + } + if in.Type() != out.Type() { + panic(fmt.Sprintf("proto.Merge(%T, %T) type mismatch", dst, src)) + } + if in.IsNil() { + return // Merge from nil src is a noop + } + if m, ok := dst.(generatedMerger); ok { + m.XXX_Merge(src) + return + } + mergeStruct(out.Elem(), in.Elem()) +} + +func mergeStruct(out, in reflect.Value) { + sprop := GetProperties(in.Type()) + for i := 0; i < in.NumField(); i++ { + f := in.Type().Field(i) + if strings.HasPrefix(f.Name, "XXX_") { + continue + } + mergeAny(out.Field(i), in.Field(i), false, sprop.Prop[i]) + } + + if emIn, ok := in.Addr().Interface().(extensionsBytes); ok { + emOut := out.Addr().Interface().(extensionsBytes) + bIn := emIn.GetExtensions() + bOut := emOut.GetExtensions() + *bOut = append(*bOut, *bIn...) + } else if emIn, err := extendable(in.Addr().Interface()); err == nil { + emOut, _ := extendable(out.Addr().Interface()) + mIn, muIn := emIn.extensionsRead() + if mIn != nil { + mOut := emOut.extensionsWrite() + muIn.Lock() + mergeExtension(mOut, mIn) + muIn.Unlock() + } + } + + uf := in.FieldByName("XXX_unrecognized") + if !uf.IsValid() { + return + } + uin := uf.Bytes() + if len(uin) > 0 { + out.FieldByName("XXX_unrecognized").SetBytes(append([]byte(nil), uin...)) + } +} + +// mergeAny performs a merge between two values of the same type. +// viaPtr indicates whether the values were indirected through a pointer (implying proto2). +// prop is set if this is a struct field (it may be nil). +func mergeAny(out, in reflect.Value, viaPtr bool, prop *Properties) { + if in.Type() == protoMessageType { + if !in.IsNil() { + if out.IsNil() { + out.Set(reflect.ValueOf(Clone(in.Interface().(Message)))) + } else { + Merge(out.Interface().(Message), in.Interface().(Message)) + } + } + return + } + switch in.Kind() { + case reflect.Bool, reflect.Float32, reflect.Float64, reflect.Int32, reflect.Int64, + reflect.String, reflect.Uint32, reflect.Uint64: + if !viaPtr && isProto3Zero(in) { + return + } + out.Set(in) + case reflect.Interface: + // Probably a oneof field; copy non-nil values. + if in.IsNil() { + return + } + // Allocate destination if it is not set, or set to a different type. + // Otherwise we will merge as normal. + if out.IsNil() || out.Elem().Type() != in.Elem().Type() { + out.Set(reflect.New(in.Elem().Elem().Type())) // interface -> *T -> T -> new(T) + } + mergeAny(out.Elem(), in.Elem(), false, nil) + case reflect.Map: + if in.Len() == 0 { + return + } + if out.IsNil() { + out.Set(reflect.MakeMap(in.Type())) + } + // For maps with value types of *T or []byte we need to deep copy each value. + elemKind := in.Type().Elem().Kind() + for _, key := range in.MapKeys() { + var val reflect.Value + switch elemKind { + case reflect.Ptr: + val = reflect.New(in.Type().Elem().Elem()) + mergeAny(val, in.MapIndex(key), false, nil) + case reflect.Slice: + val = in.MapIndex(key) + val = reflect.ValueOf(append([]byte{}, val.Bytes()...)) + default: + val = in.MapIndex(key) + } + out.SetMapIndex(key, val) + } + case reflect.Ptr: + if in.IsNil() { + return + } + if out.IsNil() { + out.Set(reflect.New(in.Elem().Type())) + } + mergeAny(out.Elem(), in.Elem(), true, nil) + case reflect.Slice: + if in.IsNil() { + return + } + if in.Type().Elem().Kind() == reflect.Uint8 { + // []byte is a scalar bytes field, not a repeated field. + + // Edge case: if this is in a proto3 message, a zero length + // bytes field is considered the zero value, and should not + // be merged. + if prop != nil && prop.proto3 && in.Len() == 0 { + return + } + + // Make a deep copy. + // Append to []byte{} instead of []byte(nil) so that we never end up + // with a nil result. + out.SetBytes(append([]byte{}, in.Bytes()...)) + return + } + n := in.Len() + if out.IsNil() { + out.Set(reflect.MakeSlice(in.Type(), 0, n)) + } + switch in.Type().Elem().Kind() { + case reflect.Bool, reflect.Float32, reflect.Float64, reflect.Int32, reflect.Int64, + reflect.String, reflect.Uint32, reflect.Uint64: + out.Set(reflect.AppendSlice(out, in)) + default: + for i := 0; i < n; i++ { + x := reflect.Indirect(reflect.New(in.Type().Elem())) + mergeAny(x, in.Index(i), false, nil) + out.Set(reflect.Append(out, x)) + } + } + case reflect.Struct: + mergeStruct(out, in) + default: + // unknown type, so not a protocol buffer + log.Printf("proto: don't know how to copy %v", in) + } +} + +func mergeExtension(out, in map[int32]Extension) { + for extNum, eIn := range in { + eOut := Extension{desc: eIn.desc} + if eIn.value != nil { + v := reflect.New(reflect.TypeOf(eIn.value)).Elem() + mergeAny(v, reflect.ValueOf(eIn.value), false, nil) + eOut.value = v.Interface() + } + if eIn.enc != nil { + eOut.enc = make([]byte, len(eIn.enc)) + copy(eOut.enc, eIn.enc) + } + + out[extNum] = eOut + } +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/custom_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/custom_gogo.go new file mode 100644 index 000000000000..24552483c6ce --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/custom_gogo.go @@ -0,0 +1,39 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2018, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import "reflect" + +type custom interface { + Marshal() ([]byte, error) + Unmarshal(data []byte) error + Size() int +} + +var customType = reflect.TypeOf((*custom)(nil)).Elem() diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/decode.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/decode.go new file mode 100644 index 000000000000..d9aa3c42d666 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/decode.go @@ -0,0 +1,428 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +/* + * Routines for decoding protocol buffer data to construct in-memory representations. + */ + +import ( + "errors" + "fmt" + "io" +) + +// errOverflow is returned when an integer is too large to be represented. +var errOverflow = errors.New("proto: integer overflow") + +// ErrInternalBadWireType is returned by generated code when an incorrect +// wire type is encountered. It does not get returned to user code. +var ErrInternalBadWireType = errors.New("proto: internal error: bad wiretype for oneof") + +// DecodeVarint reads a varint-encoded integer from the slice. +// It returns the integer and the number of bytes consumed, or +// zero if there is not enough. +// This is the format for the +// int32, int64, uint32, uint64, bool, and enum +// protocol buffer types. +func DecodeVarint(buf []byte) (x uint64, n int) { + for shift := uint(0); shift < 64; shift += 7 { + if n >= len(buf) { + return 0, 0 + } + b := uint64(buf[n]) + n++ + x |= (b & 0x7F) << shift + if (b & 0x80) == 0 { + return x, n + } + } + + // The number is too large to represent in a 64-bit value. + return 0, 0 +} + +func (p *Buffer) decodeVarintSlow() (x uint64, err error) { + i := p.index + l := len(p.buf) + + for shift := uint(0); shift < 64; shift += 7 { + if i >= l { + err = io.ErrUnexpectedEOF + return + } + b := p.buf[i] + i++ + x |= (uint64(b) & 0x7F) << shift + if b < 0x80 { + p.index = i + return + } + } + + // The number is too large to represent in a 64-bit value. + err = errOverflow + return +} + +// DecodeVarint reads a varint-encoded integer from the Buffer. +// This is the format for the +// int32, int64, uint32, uint64, bool, and enum +// protocol buffer types. +func (p *Buffer) DecodeVarint() (x uint64, err error) { + i := p.index + buf := p.buf + + if i >= len(buf) { + return 0, io.ErrUnexpectedEOF + } else if buf[i] < 0x80 { + p.index++ + return uint64(buf[i]), nil + } else if len(buf)-i < 10 { + return p.decodeVarintSlow() + } + + var b uint64 + // we already checked the first byte + x = uint64(buf[i]) - 0x80 + i++ + + b = uint64(buf[i]) + i++ + x += b << 7 + if b&0x80 == 0 { + goto done + } + x -= 0x80 << 7 + + b = uint64(buf[i]) + i++ + x += b << 14 + if b&0x80 == 0 { + goto done + } + x -= 0x80 << 14 + + b = uint64(buf[i]) + i++ + x += b << 21 + if b&0x80 == 0 { + goto done + } + x -= 0x80 << 21 + + b = uint64(buf[i]) + i++ + x += b << 28 + if b&0x80 == 0 { + goto done + } + x -= 0x80 << 28 + + b = uint64(buf[i]) + i++ + x += b << 35 + if b&0x80 == 0 { + goto done + } + x -= 0x80 << 35 + + b = uint64(buf[i]) + i++ + x += b << 42 + if b&0x80 == 0 { + goto done + } + x -= 0x80 << 42 + + b = uint64(buf[i]) + i++ + x += b << 49 + if b&0x80 == 0 { + goto done + } + x -= 0x80 << 49 + + b = uint64(buf[i]) + i++ + x += b << 56 + if b&0x80 == 0 { + goto done + } + x -= 0x80 << 56 + + b = uint64(buf[i]) + i++ + x += b << 63 + if b&0x80 == 0 { + goto done + } + // x -= 0x80 << 63 // Always zero. + + return 0, errOverflow + +done: + p.index = i + return x, nil +} + +// DecodeFixed64 reads a 64-bit integer from the Buffer. +// This is the format for the +// fixed64, sfixed64, and double protocol buffer types. +func (p *Buffer) DecodeFixed64() (x uint64, err error) { + // x, err already 0 + i := p.index + 8 + if i < 0 || i > len(p.buf) { + err = io.ErrUnexpectedEOF + return + } + p.index = i + + x = uint64(p.buf[i-8]) + x |= uint64(p.buf[i-7]) << 8 + x |= uint64(p.buf[i-6]) << 16 + x |= uint64(p.buf[i-5]) << 24 + x |= uint64(p.buf[i-4]) << 32 + x |= uint64(p.buf[i-3]) << 40 + x |= uint64(p.buf[i-2]) << 48 + x |= uint64(p.buf[i-1]) << 56 + return +} + +// DecodeFixed32 reads a 32-bit integer from the Buffer. +// This is the format for the +// fixed32, sfixed32, and float protocol buffer types. +func (p *Buffer) DecodeFixed32() (x uint64, err error) { + // x, err already 0 + i := p.index + 4 + if i < 0 || i > len(p.buf) { + err = io.ErrUnexpectedEOF + return + } + p.index = i + + x = uint64(p.buf[i-4]) + x |= uint64(p.buf[i-3]) << 8 + x |= uint64(p.buf[i-2]) << 16 + x |= uint64(p.buf[i-1]) << 24 + return +} + +// DecodeZigzag64 reads a zigzag-encoded 64-bit integer +// from the Buffer. +// This is the format used for the sint64 protocol buffer type. +func (p *Buffer) DecodeZigzag64() (x uint64, err error) { + x, err = p.DecodeVarint() + if err != nil { + return + } + x = (x >> 1) ^ uint64((int64(x&1)<<63)>>63) + return +} + +// DecodeZigzag32 reads a zigzag-encoded 32-bit integer +// from the Buffer. +// This is the format used for the sint32 protocol buffer type. +func (p *Buffer) DecodeZigzag32() (x uint64, err error) { + x, err = p.DecodeVarint() + if err != nil { + return + } + x = uint64((uint32(x) >> 1) ^ uint32((int32(x&1)<<31)>>31)) + return +} + +// DecodeRawBytes reads a count-delimited byte buffer from the Buffer. +// This is the format used for the bytes protocol buffer +// type and for embedded messages. +func (p *Buffer) DecodeRawBytes(alloc bool) (buf []byte, err error) { + n, err := p.DecodeVarint() + if err != nil { + return nil, err + } + + nb := int(n) + if nb < 0 { + return nil, fmt.Errorf("proto: bad byte length %d", nb) + } + end := p.index + nb + if end < p.index || end > len(p.buf) { + return nil, io.ErrUnexpectedEOF + } + + if !alloc { + // todo: check if can get more uses of alloc=false + buf = p.buf[p.index:end] + p.index += nb + return + } + + buf = make([]byte, nb) + copy(buf, p.buf[p.index:]) + p.index += nb + return +} + +// DecodeStringBytes reads an encoded string from the Buffer. +// This is the format used for the proto2 string type. +func (p *Buffer) DecodeStringBytes() (s string, err error) { + buf, err := p.DecodeRawBytes(false) + if err != nil { + return + } + return string(buf), nil +} + +// Unmarshaler is the interface representing objects that can +// unmarshal themselves. The argument points to data that may be +// overwritten, so implementations should not keep references to the +// buffer. +// Unmarshal implementations should not clear the receiver. +// Any unmarshaled data should be merged into the receiver. +// Callers of Unmarshal that do not want to retain existing data +// should Reset the receiver before calling Unmarshal. +type Unmarshaler interface { + Unmarshal([]byte) error +} + +// newUnmarshaler is the interface representing objects that can +// unmarshal themselves. The semantics are identical to Unmarshaler. +// +// This exists to support protoc-gen-go generated messages. +// The proto package will stop type-asserting to this interface in the future. +// +// DO NOT DEPEND ON THIS. +type newUnmarshaler interface { + XXX_Unmarshal([]byte) error +} + +// Unmarshal parses the protocol buffer representation in buf and places the +// decoded result in pb. If the struct underlying pb does not match +// the data in buf, the results can be unpredictable. +// +// Unmarshal resets pb before starting to unmarshal, so any +// existing data in pb is always removed. Use UnmarshalMerge +// to preserve and append to existing data. +func Unmarshal(buf []byte, pb Message) error { + pb.Reset() + if u, ok := pb.(newUnmarshaler); ok { + return u.XXX_Unmarshal(buf) + } + if u, ok := pb.(Unmarshaler); ok { + return u.Unmarshal(buf) + } + return NewBuffer(buf).Unmarshal(pb) +} + +// UnmarshalMerge parses the protocol buffer representation in buf and +// writes the decoded result to pb. If the struct underlying pb does not match +// the data in buf, the results can be unpredictable. +// +// UnmarshalMerge merges into existing data in pb. +// Most code should use Unmarshal instead. +func UnmarshalMerge(buf []byte, pb Message) error { + if u, ok := pb.(newUnmarshaler); ok { + return u.XXX_Unmarshal(buf) + } + if u, ok := pb.(Unmarshaler); ok { + // NOTE: The history of proto have unfortunately been inconsistent + // whether Unmarshaler should or should not implicitly clear itself. + // Some implementations do, most do not. + // Thus, calling this here may or may not do what people want. + // + // See https://github.com/golang/protobuf/issues/424 + return u.Unmarshal(buf) + } + return NewBuffer(buf).Unmarshal(pb) +} + +// DecodeMessage reads a count-delimited message from the Buffer. +func (p *Buffer) DecodeMessage(pb Message) error { + enc, err := p.DecodeRawBytes(false) + if err != nil { + return err + } + return NewBuffer(enc).Unmarshal(pb) +} + +// DecodeGroup reads a tag-delimited group from the Buffer. +// StartGroup tag is already consumed. This function consumes +// EndGroup tag. +func (p *Buffer) DecodeGroup(pb Message) error { + b := p.buf[p.index:] + x, y := findEndGroup(b) + if x < 0 { + return io.ErrUnexpectedEOF + } + err := Unmarshal(b[:x], pb) + p.index += y + return err +} + +// Unmarshal parses the protocol buffer representation in the +// Buffer and places the decoded result in pb. If the struct +// underlying pb does not match the data in the buffer, the results can be +// unpredictable. +// +// Unlike proto.Unmarshal, this does not reset pb before starting to unmarshal. +func (p *Buffer) Unmarshal(pb Message) error { + // If the object can unmarshal itself, let it. + if u, ok := pb.(newUnmarshaler); ok { + err := u.XXX_Unmarshal(p.buf[p.index:]) + p.index = len(p.buf) + return err + } + if u, ok := pb.(Unmarshaler); ok { + // NOTE: The history of proto have unfortunately been inconsistent + // whether Unmarshaler should or should not implicitly clear itself. + // Some implementations do, most do not. + // Thus, calling this here may or may not do what people want. + // + // See https://github.com/golang/protobuf/issues/424 + err := u.Unmarshal(p.buf[p.index:]) + p.index = len(p.buf) + return err + } + + // Slow workaround for messages that aren't Unmarshalers. + // This includes some hand-coded .pb.go files and + // bootstrap protos. + // TODO: fix all of those and then add Unmarshal to + // the Message interface. Then: + // The cast above and code below can be deleted. + // The old unmarshaler can be deleted. + // Clients can call Unmarshal directly (can already do that, actually). + var info InternalMessageInfo + err := info.Unmarshal(pb, p.buf[p.index:]) + p.index = len(p.buf) + return err +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/discard.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/discard.go new file mode 100644 index 000000000000..fe1bd7d904e2 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/discard.go @@ -0,0 +1,350 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2017 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "fmt" + "reflect" + "strings" + "sync" + "sync/atomic" +) + +type generatedDiscarder interface { + XXX_DiscardUnknown() +} + +// DiscardUnknown recursively discards all unknown fields from this message +// and all embedded messages. +// +// When unmarshaling a message with unrecognized fields, the tags and values +// of such fields are preserved in the Message. This allows a later call to +// marshal to be able to produce a message that continues to have those +// unrecognized fields. To avoid this, DiscardUnknown is used to +// explicitly clear the unknown fields after unmarshaling. +// +// For proto2 messages, the unknown fields of message extensions are only +// discarded from messages that have been accessed via GetExtension. +func DiscardUnknown(m Message) { + if m, ok := m.(generatedDiscarder); ok { + m.XXX_DiscardUnknown() + return + } + // TODO: Dynamically populate a InternalMessageInfo for legacy messages, + // but the master branch has no implementation for InternalMessageInfo, + // so it would be more work to replicate that approach. + discardLegacy(m) +} + +// DiscardUnknown recursively discards all unknown fields. +func (a *InternalMessageInfo) DiscardUnknown(m Message) { + di := atomicLoadDiscardInfo(&a.discard) + if di == nil { + di = getDiscardInfo(reflect.TypeOf(m).Elem()) + atomicStoreDiscardInfo(&a.discard, di) + } + di.discard(toPointer(&m)) +} + +type discardInfo struct { + typ reflect.Type + + initialized int32 // 0: only typ is valid, 1: everything is valid + lock sync.Mutex + + fields []discardFieldInfo + unrecognized field +} + +type discardFieldInfo struct { + field field // Offset of field, guaranteed to be valid + discard func(src pointer) +} + +var ( + discardInfoMap = map[reflect.Type]*discardInfo{} + discardInfoLock sync.Mutex +) + +func getDiscardInfo(t reflect.Type) *discardInfo { + discardInfoLock.Lock() + defer discardInfoLock.Unlock() + di := discardInfoMap[t] + if di == nil { + di = &discardInfo{typ: t} + discardInfoMap[t] = di + } + return di +} + +func (di *discardInfo) discard(src pointer) { + if src.isNil() { + return // Nothing to do. + } + + if atomic.LoadInt32(&di.initialized) == 0 { + di.computeDiscardInfo() + } + + for _, fi := range di.fields { + sfp := src.offset(fi.field) + fi.discard(sfp) + } + + // For proto2 messages, only discard unknown fields in message extensions + // that have been accessed via GetExtension. + if em, err := extendable(src.asPointerTo(di.typ).Interface()); err == nil { + // Ignore lock since DiscardUnknown is not concurrency safe. + emm, _ := em.extensionsRead() + for _, mx := range emm { + if m, ok := mx.value.(Message); ok { + DiscardUnknown(m) + } + } + } + + if di.unrecognized.IsValid() { + *src.offset(di.unrecognized).toBytes() = nil + } +} + +func (di *discardInfo) computeDiscardInfo() { + di.lock.Lock() + defer di.lock.Unlock() + if di.initialized != 0 { + return + } + t := di.typ + n := t.NumField() + + for i := 0; i < n; i++ { + f := t.Field(i) + if strings.HasPrefix(f.Name, "XXX_") { + continue + } + + dfi := discardFieldInfo{field: toField(&f)} + tf := f.Type + + // Unwrap tf to get its most basic type. + var isPointer, isSlice bool + if tf.Kind() == reflect.Slice && tf.Elem().Kind() != reflect.Uint8 { + isSlice = true + tf = tf.Elem() + } + if tf.Kind() == reflect.Ptr { + isPointer = true + tf = tf.Elem() + } + if isPointer && isSlice && tf.Kind() != reflect.Struct { + panic(fmt.Sprintf("%v.%s cannot be a slice of pointers to primitive types", t, f.Name)) + } + + switch tf.Kind() { + case reflect.Struct: + switch { + case !isPointer: + panic(fmt.Sprintf("%v.%s cannot be a direct struct value", t, f.Name)) + case isSlice: // E.g., []*pb.T + discardInfo := getDiscardInfo(tf) + dfi.discard = func(src pointer) { + sps := src.getPointerSlice() + for _, sp := range sps { + if !sp.isNil() { + discardInfo.discard(sp) + } + } + } + default: // E.g., *pb.T + discardInfo := getDiscardInfo(tf) + dfi.discard = func(src pointer) { + sp := src.getPointer() + if !sp.isNil() { + discardInfo.discard(sp) + } + } + } + case reflect.Map: + switch { + case isPointer || isSlice: + panic(fmt.Sprintf("%v.%s cannot be a pointer to a map or a slice of map values", t, f.Name)) + default: // E.g., map[K]V + if tf.Elem().Kind() == reflect.Ptr { // Proto struct (e.g., *T) + dfi.discard = func(src pointer) { + sm := src.asPointerTo(tf).Elem() + if sm.Len() == 0 { + return + } + for _, key := range sm.MapKeys() { + val := sm.MapIndex(key) + DiscardUnknown(val.Interface().(Message)) + } + } + } else { + dfi.discard = func(pointer) {} // Noop + } + } + case reflect.Interface: + // Must be oneof field. + switch { + case isPointer || isSlice: + panic(fmt.Sprintf("%v.%s cannot be a pointer to a interface or a slice of interface values", t, f.Name)) + default: // E.g., interface{} + // TODO: Make this faster? + dfi.discard = func(src pointer) { + su := src.asPointerTo(tf).Elem() + if !su.IsNil() { + sv := su.Elem().Elem().Field(0) + if sv.Kind() == reflect.Ptr && sv.IsNil() { + return + } + switch sv.Type().Kind() { + case reflect.Ptr: // Proto struct (e.g., *T) + DiscardUnknown(sv.Interface().(Message)) + } + } + } + } + default: + continue + } + di.fields = append(di.fields, dfi) + } + + di.unrecognized = invalidField + if f, ok := t.FieldByName("XXX_unrecognized"); ok { + if f.Type != reflect.TypeOf([]byte{}) { + panic("expected XXX_unrecognized to be of type []byte") + } + di.unrecognized = toField(&f) + } + + atomic.StoreInt32(&di.initialized, 1) +} + +func discardLegacy(m Message) { + v := reflect.ValueOf(m) + if v.Kind() != reflect.Ptr || v.IsNil() { + return + } + v = v.Elem() + if v.Kind() != reflect.Struct { + return + } + t := v.Type() + + for i := 0; i < v.NumField(); i++ { + f := t.Field(i) + if strings.HasPrefix(f.Name, "XXX_") { + continue + } + vf := v.Field(i) + tf := f.Type + + // Unwrap tf to get its most basic type. + var isPointer, isSlice bool + if tf.Kind() == reflect.Slice && tf.Elem().Kind() != reflect.Uint8 { + isSlice = true + tf = tf.Elem() + } + if tf.Kind() == reflect.Ptr { + isPointer = true + tf = tf.Elem() + } + if isPointer && isSlice && tf.Kind() != reflect.Struct { + panic(fmt.Sprintf("%T.%s cannot be a slice of pointers to primitive types", m, f.Name)) + } + + switch tf.Kind() { + case reflect.Struct: + switch { + case !isPointer: + panic(fmt.Sprintf("%T.%s cannot be a direct struct value", m, f.Name)) + case isSlice: // E.g., []*pb.T + for j := 0; j < vf.Len(); j++ { + discardLegacy(vf.Index(j).Interface().(Message)) + } + default: // E.g., *pb.T + discardLegacy(vf.Interface().(Message)) + } + case reflect.Map: + switch { + case isPointer || isSlice: + panic(fmt.Sprintf("%T.%s cannot be a pointer to a map or a slice of map values", m, f.Name)) + default: // E.g., map[K]V + tv := vf.Type().Elem() + if tv.Kind() == reflect.Ptr && tv.Implements(protoMessageType) { // Proto struct (e.g., *T) + for _, key := range vf.MapKeys() { + val := vf.MapIndex(key) + discardLegacy(val.Interface().(Message)) + } + } + } + case reflect.Interface: + // Must be oneof field. + switch { + case isPointer || isSlice: + panic(fmt.Sprintf("%T.%s cannot be a pointer to a interface or a slice of interface values", m, f.Name)) + default: // E.g., test_proto.isCommunique_Union interface + if !vf.IsNil() && f.Tag.Get("protobuf_oneof") != "" { + vf = vf.Elem() // E.g., *test_proto.Communique_Msg + if !vf.IsNil() { + vf = vf.Elem() // E.g., test_proto.Communique_Msg + vf = vf.Field(0) // E.g., Proto struct (e.g., *T) or primitive value + if vf.Kind() == reflect.Ptr { + discardLegacy(vf.Interface().(Message)) + } + } + } + } + } + } + + if vf := v.FieldByName("XXX_unrecognized"); vf.IsValid() { + if vf.Type() != reflect.TypeOf([]byte{}) { + panic("expected XXX_unrecognized to be of type []byte") + } + vf.Set(reflect.ValueOf([]byte(nil))) + } + + // For proto2 messages, only discard unknown fields in message extensions + // that have been accessed via GetExtension. + if em, err := extendable(m); err == nil { + // Ignore lock since discardLegacy is not concurrency safe. + emm, _ := em.extensionsRead() + for _, mx := range emm { + if m, ok := mx.value.(Message); ok { + discardLegacy(m) + } + } + } +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/duration.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/duration.go new file mode 100644 index 000000000000..93464c91cffb --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/duration.go @@ -0,0 +1,100 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2016 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +// This file implements conversions between google.protobuf.Duration +// and time.Duration. + +import ( + "errors" + "fmt" + "time" +) + +const ( + // Range of a Duration in seconds, as specified in + // google/protobuf/duration.proto. This is about 10,000 years in seconds. + maxSeconds = int64(10000 * 365.25 * 24 * 60 * 60) + minSeconds = -maxSeconds +) + +// validateDuration determines whether the Duration is valid according to the +// definition in google/protobuf/duration.proto. A valid Duration +// may still be too large to fit into a time.Duration (the range of Duration +// is about 10,000 years, and the range of time.Duration is about 290). +func validateDuration(d *duration) error { + if d == nil { + return errors.New("duration: nil Duration") + } + if d.Seconds < minSeconds || d.Seconds > maxSeconds { + return fmt.Errorf("duration: %#v: seconds out of range", d) + } + if d.Nanos <= -1e9 || d.Nanos >= 1e9 { + return fmt.Errorf("duration: %#v: nanos out of range", d) + } + // Seconds and Nanos must have the same sign, unless d.Nanos is zero. + if (d.Seconds < 0 && d.Nanos > 0) || (d.Seconds > 0 && d.Nanos < 0) { + return fmt.Errorf("duration: %#v: seconds and nanos have different signs", d) + } + return nil +} + +// DurationFromProto converts a Duration to a time.Duration. DurationFromProto +// returns an error if the Duration is invalid or is too large to be +// represented in a time.Duration. +func durationFromProto(p *duration) (time.Duration, error) { + if err := validateDuration(p); err != nil { + return 0, err + } + d := time.Duration(p.Seconds) * time.Second + if int64(d/time.Second) != p.Seconds { + return 0, fmt.Errorf("duration: %#v is out of range for time.Duration", p) + } + if p.Nanos != 0 { + d += time.Duration(p.Nanos) + if (d < 0) != (p.Nanos < 0) { + return 0, fmt.Errorf("duration: %#v is out of range for time.Duration", p) + } + } + return d, nil +} + +// DurationProto converts a time.Duration to a Duration. +func durationProto(d time.Duration) *duration { + nanos := d.Nanoseconds() + secs := nanos / 1e9 + nanos -= secs * 1e9 + return &duration{ + Seconds: secs, + Nanos: int32(nanos), + } +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/duration_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/duration_gogo.go new file mode 100644 index 000000000000..e748e1730e1c --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/duration_gogo.go @@ -0,0 +1,49 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2016, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "reflect" + "time" +) + +var durationType = reflect.TypeOf((*time.Duration)(nil)).Elem() + +type duration struct { + Seconds int64 `protobuf:"varint,1,opt,name=seconds,proto3" json:"seconds,omitempty"` + Nanos int32 `protobuf:"varint,2,opt,name=nanos,proto3" json:"nanos,omitempty"` +} + +func (m *duration) Reset() { *m = duration{} } +func (*duration) ProtoMessage() {} +func (*duration) String() string { return "duration" } + +func init() { + RegisterType((*duration)(nil), "gogo.protobuf.proto.duration") +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/encode.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/encode.go new file mode 100644 index 000000000000..c27d35f866bb --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/encode.go @@ -0,0 +1,221 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +/* + * Routines for encoding data into the wire format for protocol buffers. + */ + +import ( + "errors" + "fmt" + "reflect" +) + +// RequiredNotSetError is the error returned if Marshal is called with +// a protocol buffer struct whose required fields have not +// all been initialized. It is also the error returned if Unmarshal is +// called with an encoded protocol buffer that does not include all the +// required fields. +// +// When printed, RequiredNotSetError reports the first unset required field in a +// message. If the field cannot be precisely determined, it is reported as +// "{Unknown}". +type RequiredNotSetError struct { + field string +} + +func (e *RequiredNotSetError) Error() string { + return fmt.Sprintf("proto: required field %q not set", e.field) +} + +var ( + // errRepeatedHasNil is the error returned if Marshal is called with + // a struct with a repeated field containing a nil element. + errRepeatedHasNil = errors.New("proto: repeated field has nil element") + + // errOneofHasNil is the error returned if Marshal is called with + // a struct with a oneof field containing a nil element. + errOneofHasNil = errors.New("proto: oneof field has nil value") + + // ErrNil is the error returned if Marshal is called with nil. + ErrNil = errors.New("proto: Marshal called with nil") + + // ErrTooLarge is the error returned if Marshal is called with a + // message that encodes to >2GB. + ErrTooLarge = errors.New("proto: message encodes to over 2 GB") +) + +// The fundamental encoders that put bytes on the wire. +// Those that take integer types all accept uint64 and are +// therefore of type valueEncoder. + +const maxVarintBytes = 10 // maximum length of a varint + +// EncodeVarint returns the varint encoding of x. +// This is the format for the +// int32, int64, uint32, uint64, bool, and enum +// protocol buffer types. +// Not used by the package itself, but helpful to clients +// wishing to use the same encoding. +func EncodeVarint(x uint64) []byte { + var buf [maxVarintBytes]byte + var n int + for n = 0; x > 127; n++ { + buf[n] = 0x80 | uint8(x&0x7F) + x >>= 7 + } + buf[n] = uint8(x) + n++ + return buf[0:n] +} + +// EncodeVarint writes a varint-encoded integer to the Buffer. +// This is the format for the +// int32, int64, uint32, uint64, bool, and enum +// protocol buffer types. +func (p *Buffer) EncodeVarint(x uint64) error { + for x >= 1<<7 { + p.buf = append(p.buf, uint8(x&0x7f|0x80)) + x >>= 7 + } + p.buf = append(p.buf, uint8(x)) + return nil +} + +// SizeVarint returns the varint encoding size of an integer. +func SizeVarint(x uint64) int { + switch { + case x < 1<<7: + return 1 + case x < 1<<14: + return 2 + case x < 1<<21: + return 3 + case x < 1<<28: + return 4 + case x < 1<<35: + return 5 + case x < 1<<42: + return 6 + case x < 1<<49: + return 7 + case x < 1<<56: + return 8 + case x < 1<<63: + return 9 + } + return 10 +} + +// EncodeFixed64 writes a 64-bit integer to the Buffer. +// This is the format for the +// fixed64, sfixed64, and double protocol buffer types. +func (p *Buffer) EncodeFixed64(x uint64) error { + p.buf = append(p.buf, + uint8(x), + uint8(x>>8), + uint8(x>>16), + uint8(x>>24), + uint8(x>>32), + uint8(x>>40), + uint8(x>>48), + uint8(x>>56)) + return nil +} + +// EncodeFixed32 writes a 32-bit integer to the Buffer. +// This is the format for the +// fixed32, sfixed32, and float protocol buffer types. +func (p *Buffer) EncodeFixed32(x uint64) error { + p.buf = append(p.buf, + uint8(x), + uint8(x>>8), + uint8(x>>16), + uint8(x>>24)) + return nil +} + +// EncodeZigzag64 writes a zigzag-encoded 64-bit integer +// to the Buffer. +// This is the format used for the sint64 protocol buffer type. +func (p *Buffer) EncodeZigzag64(x uint64) error { + // use signed number to get arithmetic right shift. + return p.EncodeVarint(uint64((x << 1) ^ uint64((int64(x) >> 63)))) +} + +// EncodeZigzag32 writes a zigzag-encoded 32-bit integer +// to the Buffer. +// This is the format used for the sint32 protocol buffer type. +func (p *Buffer) EncodeZigzag32(x uint64) error { + // use signed number to get arithmetic right shift. + return p.EncodeVarint(uint64((uint32(x) << 1) ^ uint32((int32(x) >> 31)))) +} + +// EncodeRawBytes writes a count-delimited byte buffer to the Buffer. +// This is the format used for the bytes protocol buffer +// type and for embedded messages. +func (p *Buffer) EncodeRawBytes(b []byte) error { + p.EncodeVarint(uint64(len(b))) + p.buf = append(p.buf, b...) + return nil +} + +// EncodeStringBytes writes an encoded string to the Buffer. +// This is the format used for the proto2 string type. +func (p *Buffer) EncodeStringBytes(s string) error { + p.EncodeVarint(uint64(len(s))) + p.buf = append(p.buf, s...) + return nil +} + +// Marshaler is the interface representing objects that can marshal themselves. +type Marshaler interface { + Marshal() ([]byte, error) +} + +// EncodeMessage writes the protocol buffer to the Buffer, +// prefixed by a varint-encoded length. +func (p *Buffer) EncodeMessage(pb Message) error { + siz := Size(pb) + p.EncodeVarint(uint64(siz)) + return p.Marshal(pb) +} + +// All protocol buffer fields are nillable, but be careful. +func isNil(v reflect.Value) bool { + switch v.Kind() { + case reflect.Interface, reflect.Map, reflect.Ptr, reflect.Slice: + return v.IsNil() + } + return false +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/encode_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/encode_gogo.go new file mode 100644 index 000000000000..0f5fb173e9fd --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/encode_gogo.go @@ -0,0 +1,33 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2013, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +func NewRequiredNotSetError(field string) *RequiredNotSetError { + return &RequiredNotSetError{field} +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/equal.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/equal.go new file mode 100644 index 000000000000..d4db5a1c1457 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/equal.go @@ -0,0 +1,300 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2011 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// Protocol buffer comparison. + +package proto + +import ( + "bytes" + "log" + "reflect" + "strings" +) + +/* +Equal returns true iff protocol buffers a and b are equal. +The arguments must both be pointers to protocol buffer structs. + +Equality is defined in this way: + - Two messages are equal iff they are the same type, + corresponding fields are equal, unknown field sets + are equal, and extensions sets are equal. + - Two set scalar fields are equal iff their values are equal. + If the fields are of a floating-point type, remember that + NaN != x for all x, including NaN. If the message is defined + in a proto3 .proto file, fields are not "set"; specifically, + zero length proto3 "bytes" fields are equal (nil == {}). + - Two repeated fields are equal iff their lengths are the same, + and their corresponding elements are equal. Note a "bytes" field, + although represented by []byte, is not a repeated field and the + rule for the scalar fields described above applies. + - Two unset fields are equal. + - Two unknown field sets are equal if their current + encoded state is equal. + - Two extension sets are equal iff they have corresponding + elements that are pairwise equal. + - Two map fields are equal iff their lengths are the same, + and they contain the same set of elements. Zero-length map + fields are equal. + - Every other combination of things are not equal. + +The return value is undefined if a and b are not protocol buffers. +*/ +func Equal(a, b Message) bool { + if a == nil || b == nil { + return a == b + } + v1, v2 := reflect.ValueOf(a), reflect.ValueOf(b) + if v1.Type() != v2.Type() { + return false + } + if v1.Kind() == reflect.Ptr { + if v1.IsNil() { + return v2.IsNil() + } + if v2.IsNil() { + return false + } + v1, v2 = v1.Elem(), v2.Elem() + } + if v1.Kind() != reflect.Struct { + return false + } + return equalStruct(v1, v2) +} + +// v1 and v2 are known to have the same type. +func equalStruct(v1, v2 reflect.Value) bool { + sprop := GetProperties(v1.Type()) + for i := 0; i < v1.NumField(); i++ { + f := v1.Type().Field(i) + if strings.HasPrefix(f.Name, "XXX_") { + continue + } + f1, f2 := v1.Field(i), v2.Field(i) + if f.Type.Kind() == reflect.Ptr { + if n1, n2 := f1.IsNil(), f2.IsNil(); n1 && n2 { + // both unset + continue + } else if n1 != n2 { + // set/unset mismatch + return false + } + f1, f2 = f1.Elem(), f2.Elem() + } + if !equalAny(f1, f2, sprop.Prop[i]) { + return false + } + } + + if em1 := v1.FieldByName("XXX_InternalExtensions"); em1.IsValid() { + em2 := v2.FieldByName("XXX_InternalExtensions") + if !equalExtensions(v1.Type(), em1.Interface().(XXX_InternalExtensions), em2.Interface().(XXX_InternalExtensions)) { + return false + } + } + + if em1 := v1.FieldByName("XXX_extensions"); em1.IsValid() { + em2 := v2.FieldByName("XXX_extensions") + if !equalExtMap(v1.Type(), em1.Interface().(map[int32]Extension), em2.Interface().(map[int32]Extension)) { + return false + } + } + + uf := v1.FieldByName("XXX_unrecognized") + if !uf.IsValid() { + return true + } + + u1 := uf.Bytes() + u2 := v2.FieldByName("XXX_unrecognized").Bytes() + return bytes.Equal(u1, u2) +} + +// v1 and v2 are known to have the same type. +// prop may be nil. +func equalAny(v1, v2 reflect.Value, prop *Properties) bool { + if v1.Type() == protoMessageType { + m1, _ := v1.Interface().(Message) + m2, _ := v2.Interface().(Message) + return Equal(m1, m2) + } + switch v1.Kind() { + case reflect.Bool: + return v1.Bool() == v2.Bool() + case reflect.Float32, reflect.Float64: + return v1.Float() == v2.Float() + case reflect.Int32, reflect.Int64: + return v1.Int() == v2.Int() + case reflect.Interface: + // Probably a oneof field; compare the inner values. + n1, n2 := v1.IsNil(), v2.IsNil() + if n1 || n2 { + return n1 == n2 + } + e1, e2 := v1.Elem(), v2.Elem() + if e1.Type() != e2.Type() { + return false + } + return equalAny(e1, e2, nil) + case reflect.Map: + if v1.Len() != v2.Len() { + return false + } + for _, key := range v1.MapKeys() { + val2 := v2.MapIndex(key) + if !val2.IsValid() { + // This key was not found in the second map. + return false + } + if !equalAny(v1.MapIndex(key), val2, nil) { + return false + } + } + return true + case reflect.Ptr: + // Maps may have nil values in them, so check for nil. + if v1.IsNil() && v2.IsNil() { + return true + } + if v1.IsNil() != v2.IsNil() { + return false + } + return equalAny(v1.Elem(), v2.Elem(), prop) + case reflect.Slice: + if v1.Type().Elem().Kind() == reflect.Uint8 { + // short circuit: []byte + + // Edge case: if this is in a proto3 message, a zero length + // bytes field is considered the zero value. + if prop != nil && prop.proto3 && v1.Len() == 0 && v2.Len() == 0 { + return true + } + if v1.IsNil() != v2.IsNil() { + return false + } + return bytes.Equal(v1.Interface().([]byte), v2.Interface().([]byte)) + } + + if v1.Len() != v2.Len() { + return false + } + for i := 0; i < v1.Len(); i++ { + if !equalAny(v1.Index(i), v2.Index(i), prop) { + return false + } + } + return true + case reflect.String: + return v1.Interface().(string) == v2.Interface().(string) + case reflect.Struct: + return equalStruct(v1, v2) + case reflect.Uint32, reflect.Uint64: + return v1.Uint() == v2.Uint() + } + + // unknown type, so not a protocol buffer + log.Printf("proto: don't know how to compare %v", v1) + return false +} + +// base is the struct type that the extensions are based on. +// x1 and x2 are InternalExtensions. +func equalExtensions(base reflect.Type, x1, x2 XXX_InternalExtensions) bool { + em1, _ := x1.extensionsRead() + em2, _ := x2.extensionsRead() + return equalExtMap(base, em1, em2) +} + +func equalExtMap(base reflect.Type, em1, em2 map[int32]Extension) bool { + if len(em1) != len(em2) { + return false + } + + for extNum, e1 := range em1 { + e2, ok := em2[extNum] + if !ok { + return false + } + + m1, m2 := e1.value, e2.value + + if m1 == nil && m2 == nil { + // Both have only encoded form. + if bytes.Equal(e1.enc, e2.enc) { + continue + } + // The bytes are different, but the extensions might still be + // equal. We need to decode them to compare. + } + + if m1 != nil && m2 != nil { + // Both are unencoded. + if !equalAny(reflect.ValueOf(m1), reflect.ValueOf(m2), nil) { + return false + } + continue + } + + // At least one is encoded. To do a semantically correct comparison + // we need to unmarshal them first. + var desc *ExtensionDesc + if m := extensionMaps[base]; m != nil { + desc = m[extNum] + } + if desc == nil { + // If both have only encoded form and the bytes are the same, + // it is handled above. We get here when the bytes are different. + // We don't know how to decode it, so just compare them as byte + // slices. + log.Printf("proto: don't know how to compare extension %d of %v", extNum, base) + return false + } + var err error + if m1 == nil { + m1, err = decodeExtension(e1.enc, desc) + } + if m2 == nil && err == nil { + m2, err = decodeExtension(e2.enc, desc) + } + if err != nil { + // The encoded form is invalid. + log.Printf("proto: badly encoded extension %d of %v: %v", extNum, base, err) + return false + } + if !equalAny(reflect.ValueOf(m1), reflect.ValueOf(m2), nil) { + return false + } + } + + return true +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/extensions.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/extensions.go new file mode 100644 index 000000000000..44ebd457cf61 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/extensions.go @@ -0,0 +1,604 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +/* + * Types and routines for supporting protocol buffer extensions. + */ + +import ( + "errors" + "fmt" + "io" + "reflect" + "strconv" + "sync" +) + +// ErrMissingExtension is the error returned by GetExtension if the named extension is not in the message. +var ErrMissingExtension = errors.New("proto: missing extension") + +// ExtensionRange represents a range of message extensions for a protocol buffer. +// Used in code generated by the protocol compiler. +type ExtensionRange struct { + Start, End int32 // both inclusive +} + +// extendableProto is an interface implemented by any protocol buffer generated by the current +// proto compiler that may be extended. +type extendableProto interface { + Message + ExtensionRangeArray() []ExtensionRange + extensionsWrite() map[int32]Extension + extensionsRead() (map[int32]Extension, sync.Locker) +} + +// extendableProtoV1 is an interface implemented by a protocol buffer generated by the previous +// version of the proto compiler that may be extended. +type extendableProtoV1 interface { + Message + ExtensionRangeArray() []ExtensionRange + ExtensionMap() map[int32]Extension +} + +// extensionAdapter is a wrapper around extendableProtoV1 that implements extendableProto. +type extensionAdapter struct { + extendableProtoV1 +} + +func (e extensionAdapter) extensionsWrite() map[int32]Extension { + return e.ExtensionMap() +} + +func (e extensionAdapter) extensionsRead() (map[int32]Extension, sync.Locker) { + return e.ExtensionMap(), notLocker{} +} + +// notLocker is a sync.Locker whose Lock and Unlock methods are nops. +type notLocker struct{} + +func (n notLocker) Lock() {} +func (n notLocker) Unlock() {} + +// extendable returns the extendableProto interface for the given generated proto message. +// If the proto message has the old extension format, it returns a wrapper that implements +// the extendableProto interface. +func extendable(p interface{}) (extendableProto, error) { + switch p := p.(type) { + case extendableProto: + if isNilPtr(p) { + return nil, fmt.Errorf("proto: nil %T is not extendable", p) + } + return p, nil + case extendableProtoV1: + if isNilPtr(p) { + return nil, fmt.Errorf("proto: nil %T is not extendable", p) + } + return extensionAdapter{p}, nil + case extensionsBytes: + return slowExtensionAdapter{p}, nil + } + // Don't allocate a specific error containing %T: + // this is the hot path for Clone and MarshalText. + return nil, errNotExtendable +} + +var errNotExtendable = errors.New("proto: not an extendable proto.Message") + +func isNilPtr(x interface{}) bool { + v := reflect.ValueOf(x) + return v.Kind() == reflect.Ptr && v.IsNil() +} + +// XXX_InternalExtensions is an internal representation of proto extensions. +// +// Each generated message struct type embeds an anonymous XXX_InternalExtensions field, +// thus gaining the unexported 'extensions' method, which can be called only from the proto package. +// +// The methods of XXX_InternalExtensions are not concurrency safe in general, +// but calls to logically read-only methods such as has and get may be executed concurrently. +type XXX_InternalExtensions struct { + // The struct must be indirect so that if a user inadvertently copies a + // generated message and its embedded XXX_InternalExtensions, they + // avoid the mayhem of a copied mutex. + // + // The mutex serializes all logically read-only operations to p.extensionMap. + // It is up to the client to ensure that write operations to p.extensionMap are + // mutually exclusive with other accesses. + p *struct { + mu sync.Mutex + extensionMap map[int32]Extension + } +} + +// extensionsWrite returns the extension map, creating it on first use. +func (e *XXX_InternalExtensions) extensionsWrite() map[int32]Extension { + if e.p == nil { + e.p = new(struct { + mu sync.Mutex + extensionMap map[int32]Extension + }) + e.p.extensionMap = make(map[int32]Extension) + } + return e.p.extensionMap +} + +// extensionsRead returns the extensions map for read-only use. It may be nil. +// The caller must hold the returned mutex's lock when accessing Elements within the map. +func (e *XXX_InternalExtensions) extensionsRead() (map[int32]Extension, sync.Locker) { + if e.p == nil { + return nil, nil + } + return e.p.extensionMap, &e.p.mu +} + +// ExtensionDesc represents an extension specification. +// Used in generated code from the protocol compiler. +type ExtensionDesc struct { + ExtendedType Message // nil pointer to the type that is being extended + ExtensionType interface{} // nil pointer to the extension type + Field int32 // field number + Name string // fully-qualified name of extension, for text formatting + Tag string // protobuf tag style + Filename string // name of the file in which the extension is defined +} + +func (ed *ExtensionDesc) repeated() bool { + t := reflect.TypeOf(ed.ExtensionType) + return t.Kind() == reflect.Slice && t.Elem().Kind() != reflect.Uint8 +} + +// Extension represents an extension in a message. +type Extension struct { + // When an extension is stored in a message using SetExtension + // only desc and value are set. When the message is marshaled + // enc will be set to the encoded form of the message. + // + // When a message is unmarshaled and contains extensions, each + // extension will have only enc set. When such an extension is + // accessed using GetExtension (or GetExtensions) desc and value + // will be set. + desc *ExtensionDesc + value interface{} + enc []byte +} + +// SetRawExtension is for testing only. +func SetRawExtension(base Message, id int32, b []byte) { + if ebase, ok := base.(extensionsBytes); ok { + clearExtension(base, id) + ext := ebase.GetExtensions() + *ext = append(*ext, b...) + return + } + epb, err := extendable(base) + if err != nil { + return + } + extmap := epb.extensionsWrite() + extmap[id] = Extension{enc: b} +} + +// isExtensionField returns true iff the given field number is in an extension range. +func isExtensionField(pb extendableProto, field int32) bool { + for _, er := range pb.ExtensionRangeArray() { + if er.Start <= field && field <= er.End { + return true + } + } + return false +} + +// checkExtensionTypes checks that the given extension is valid for pb. +func checkExtensionTypes(pb extendableProto, extension *ExtensionDesc) error { + var pbi interface{} = pb + // Check the extended type. + if ea, ok := pbi.(extensionAdapter); ok { + pbi = ea.extendableProtoV1 + } + if ea, ok := pbi.(slowExtensionAdapter); ok { + pbi = ea.extensionsBytes + } + if a, b := reflect.TypeOf(pbi), reflect.TypeOf(extension.ExtendedType); a != b { + return fmt.Errorf("proto: bad extended type; %v does not extend %v", b, a) + } + // Check the range. + if !isExtensionField(pb, extension.Field) { + return errors.New("proto: bad extension number; not in declared ranges") + } + return nil +} + +// extPropKey is sufficient to uniquely identify an extension. +type extPropKey struct { + base reflect.Type + field int32 +} + +var extProp = struct { + sync.RWMutex + m map[extPropKey]*Properties +}{ + m: make(map[extPropKey]*Properties), +} + +func extensionProperties(ed *ExtensionDesc) *Properties { + key := extPropKey{base: reflect.TypeOf(ed.ExtendedType), field: ed.Field} + + extProp.RLock() + if prop, ok := extProp.m[key]; ok { + extProp.RUnlock() + return prop + } + extProp.RUnlock() + + extProp.Lock() + defer extProp.Unlock() + // Check again. + if prop, ok := extProp.m[key]; ok { + return prop + } + + prop := new(Properties) + prop.Init(reflect.TypeOf(ed.ExtensionType), "unknown_name", ed.Tag, nil) + extProp.m[key] = prop + return prop +} + +// HasExtension returns whether the given extension is present in pb. +func HasExtension(pb Message, extension *ExtensionDesc) bool { + if epb, doki := pb.(extensionsBytes); doki { + ext := epb.GetExtensions() + buf := *ext + o := 0 + for o < len(buf) { + tag, n := DecodeVarint(buf[o:]) + fieldNum := int32(tag >> 3) + if int32(fieldNum) == extension.Field { + return true + } + wireType := int(tag & 0x7) + o += n + l, err := size(buf[o:], wireType) + if err != nil { + return false + } + o += l + } + return false + } + // TODO: Check types, field numbers, etc.? + epb, err := extendable(pb) + if err != nil { + return false + } + extmap, mu := epb.extensionsRead() + if extmap == nil { + return false + } + mu.Lock() + _, ok := extmap[extension.Field] + mu.Unlock() + return ok +} + +// ClearExtension removes the given extension from pb. +func ClearExtension(pb Message, extension *ExtensionDesc) { + clearExtension(pb, extension.Field) +} + +func clearExtension(pb Message, fieldNum int32) { + if epb, ok := pb.(extensionsBytes); ok { + offset := 0 + for offset != -1 { + offset = deleteExtension(epb, fieldNum, offset) + } + return + } + epb, err := extendable(pb) + if err != nil { + return + } + // TODO: Check types, field numbers, etc.? + extmap := epb.extensionsWrite() + delete(extmap, fieldNum) +} + +// GetExtension retrieves a proto2 extended field from pb. +// +// If the descriptor is type complete (i.e., ExtensionDesc.ExtensionType is non-nil), +// then GetExtension parses the encoded field and returns a Go value of the specified type. +// If the field is not present, then the default value is returned (if one is specified), +// otherwise ErrMissingExtension is reported. +// +// If the descriptor is not type complete (i.e., ExtensionDesc.ExtensionType is nil), +// then GetExtension returns the raw encoded bytes of the field extension. +func GetExtension(pb Message, extension *ExtensionDesc) (interface{}, error) { + if epb, doki := pb.(extensionsBytes); doki { + ext := epb.GetExtensions() + return decodeExtensionFromBytes(extension, *ext) + } + + epb, err := extendable(pb) + if err != nil { + return nil, err + } + + if extension.ExtendedType != nil { + // can only check type if this is a complete descriptor + if cerr := checkExtensionTypes(epb, extension); cerr != nil { + return nil, cerr + } + } + + emap, mu := epb.extensionsRead() + if emap == nil { + return defaultExtensionValue(extension) + } + mu.Lock() + defer mu.Unlock() + e, ok := emap[extension.Field] + if !ok { + // defaultExtensionValue returns the default value or + // ErrMissingExtension if there is no default. + return defaultExtensionValue(extension) + } + + if e.value != nil { + // Already decoded. Check the descriptor, though. + if e.desc != extension { + // This shouldn't happen. If it does, it means that + // GetExtension was called twice with two different + // descriptors with the same field number. + return nil, errors.New("proto: descriptor conflict") + } + return e.value, nil + } + + if extension.ExtensionType == nil { + // incomplete descriptor + return e.enc, nil + } + + v, err := decodeExtension(e.enc, extension) + if err != nil { + return nil, err + } + + // Remember the decoded version and drop the encoded version. + // That way it is safe to mutate what we return. + e.value = v + e.desc = extension + e.enc = nil + emap[extension.Field] = e + return e.value, nil +} + +// defaultExtensionValue returns the default value for extension. +// If no default for an extension is defined ErrMissingExtension is returned. +func defaultExtensionValue(extension *ExtensionDesc) (interface{}, error) { + if extension.ExtensionType == nil { + // incomplete descriptor, so no default + return nil, ErrMissingExtension + } + + t := reflect.TypeOf(extension.ExtensionType) + props := extensionProperties(extension) + + sf, _, err := fieldDefault(t, props) + if err != nil { + return nil, err + } + + if sf == nil || sf.value == nil { + // There is no default value. + return nil, ErrMissingExtension + } + + if t.Kind() != reflect.Ptr { + // We do not need to return a Ptr, we can directly return sf.value. + return sf.value, nil + } + + // We need to return an interface{} that is a pointer to sf.value. + value := reflect.New(t).Elem() + value.Set(reflect.New(value.Type().Elem())) + if sf.kind == reflect.Int32 { + // We may have an int32 or an enum, but the underlying data is int32. + // Since we can't set an int32 into a non int32 reflect.value directly + // set it as a int32. + value.Elem().SetInt(int64(sf.value.(int32))) + } else { + value.Elem().Set(reflect.ValueOf(sf.value)) + } + return value.Interface(), nil +} + +// decodeExtension decodes an extension encoded in b. +func decodeExtension(b []byte, extension *ExtensionDesc) (interface{}, error) { + t := reflect.TypeOf(extension.ExtensionType) + unmarshal := typeUnmarshaler(t, extension.Tag) + + // t is a pointer to a struct, pointer to basic type or a slice. + // Allocate space to store the pointer/slice. + value := reflect.New(t).Elem() + + var err error + for { + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + wire := int(x) & 7 + + b, err = unmarshal(b, valToPointer(value.Addr()), wire) + if err != nil { + return nil, err + } + + if len(b) == 0 { + break + } + } + return value.Interface(), nil +} + +// GetExtensions returns a slice of the extensions present in pb that are also listed in es. +// The returned slice has the same length as es; missing extensions will appear as nil elements. +func GetExtensions(pb Message, es []*ExtensionDesc) (extensions []interface{}, err error) { + epb, err := extendable(pb) + if err != nil { + return nil, err + } + extensions = make([]interface{}, len(es)) + for i, e := range es { + extensions[i], err = GetExtension(epb, e) + if err == ErrMissingExtension { + err = nil + } + if err != nil { + return + } + } + return +} + +// ExtensionDescs returns a new slice containing pb's extension descriptors, in undefined order. +// For non-registered extensions, ExtensionDescs returns an incomplete descriptor containing +// just the Field field, which defines the extension's field number. +func ExtensionDescs(pb Message) ([]*ExtensionDesc, error) { + epb, err := extendable(pb) + if err != nil { + return nil, err + } + registeredExtensions := RegisteredExtensions(pb) + + emap, mu := epb.extensionsRead() + if emap == nil { + return nil, nil + } + mu.Lock() + defer mu.Unlock() + extensions := make([]*ExtensionDesc, 0, len(emap)) + for extid, e := range emap { + desc := e.desc + if desc == nil { + desc = registeredExtensions[extid] + if desc == nil { + desc = &ExtensionDesc{Field: extid} + } + } + + extensions = append(extensions, desc) + } + return extensions, nil +} + +// SetExtension sets the specified extension of pb to the specified value. +func SetExtension(pb Message, extension *ExtensionDesc, value interface{}) error { + if epb, ok := pb.(extensionsBytes); ok { + newb, err := encodeExtension(extension, value) + if err != nil { + return err + } + bb := epb.GetExtensions() + *bb = append(*bb, newb...) + return nil + } + epb, err := extendable(pb) + if err != nil { + return err + } + if err := checkExtensionTypes(epb, extension); err != nil { + return err + } + typ := reflect.TypeOf(extension.ExtensionType) + if typ != reflect.TypeOf(value) { + return errors.New("proto: bad extension value type") + } + // nil extension values need to be caught early, because the + // encoder can't distinguish an ErrNil due to a nil extension + // from an ErrNil due to a missing field. Extensions are + // always optional, so the encoder would just swallow the error + // and drop all the extensions from the encoded message. + if reflect.ValueOf(value).IsNil() { + return fmt.Errorf("proto: SetExtension called with nil value of type %T", value) + } + + extmap := epb.extensionsWrite() + extmap[extension.Field] = Extension{desc: extension, value: value} + return nil +} + +// ClearAllExtensions clears all extensions from pb. +func ClearAllExtensions(pb Message) { + if epb, doki := pb.(extensionsBytes); doki { + ext := epb.GetExtensions() + *ext = []byte{} + return + } + epb, err := extendable(pb) + if err != nil { + return + } + m := epb.extensionsWrite() + for k := range m { + delete(m, k) + } +} + +// A global registry of extensions. +// The generated code will register the generated descriptors by calling RegisterExtension. + +var extensionMaps = make(map[reflect.Type]map[int32]*ExtensionDesc) + +// RegisterExtension is called from the generated code. +func RegisterExtension(desc *ExtensionDesc) { + st := reflect.TypeOf(desc.ExtendedType).Elem() + m := extensionMaps[st] + if m == nil { + m = make(map[int32]*ExtensionDesc) + extensionMaps[st] = m + } + if _, ok := m[desc.Field]; ok { + panic("proto: duplicate extension registered: " + st.String() + " " + strconv.Itoa(int(desc.Field))) + } + m[desc.Field] = desc +} + +// RegisteredExtensions returns a map of the registered extensions of a +// protocol buffer struct, indexed by the extension number. +// The argument pb should be a nil pointer to the struct type. +func RegisteredExtensions(pb Message) map[int32]*ExtensionDesc { + return extensionMaps[reflect.TypeOf(pb).Elem()] +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/extensions_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/extensions_gogo.go new file mode 100644 index 000000000000..53ebd8cca01c --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/extensions_gogo.go @@ -0,0 +1,368 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2013, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "bytes" + "errors" + "fmt" + "io" + "reflect" + "sort" + "strings" + "sync" +) + +type extensionsBytes interface { + Message + ExtensionRangeArray() []ExtensionRange + GetExtensions() *[]byte +} + +type slowExtensionAdapter struct { + extensionsBytes +} + +func (s slowExtensionAdapter) extensionsWrite() map[int32]Extension { + panic("Please report a bug to github.com/gogo/protobuf if you see this message: Writing extensions is not supported for extensions stored in a byte slice field.") +} + +func (s slowExtensionAdapter) extensionsRead() (map[int32]Extension, sync.Locker) { + b := s.GetExtensions() + m, err := BytesToExtensionsMap(*b) + if err != nil { + panic(err) + } + return m, notLocker{} +} + +func GetBoolExtension(pb Message, extension *ExtensionDesc, ifnotset bool) bool { + if reflect.ValueOf(pb).IsNil() { + return ifnotset + } + value, err := GetExtension(pb, extension) + if err != nil { + return ifnotset + } + if value == nil { + return ifnotset + } + if value.(*bool) == nil { + return ifnotset + } + return *(value.(*bool)) +} + +func (this *Extension) Equal(that *Extension) bool { + if err := this.Encode(); err != nil { + return false + } + if err := that.Encode(); err != nil { + return false + } + return bytes.Equal(this.enc, that.enc) +} + +func (this *Extension) Compare(that *Extension) int { + if err := this.Encode(); err != nil { + return 1 + } + if err := that.Encode(); err != nil { + return -1 + } + return bytes.Compare(this.enc, that.enc) +} + +func SizeOfInternalExtension(m extendableProto) (n int) { + info := getMarshalInfo(reflect.TypeOf(m)) + return info.sizeV1Extensions(m.extensionsWrite()) +} + +type sortableMapElem struct { + field int32 + ext Extension +} + +func newSortableExtensionsFromMap(m map[int32]Extension) sortableExtensions { + s := make(sortableExtensions, 0, len(m)) + for k, v := range m { + s = append(s, &sortableMapElem{field: k, ext: v}) + } + return s +} + +type sortableExtensions []*sortableMapElem + +func (this sortableExtensions) Len() int { return len(this) } + +func (this sortableExtensions) Swap(i, j int) { this[i], this[j] = this[j], this[i] } + +func (this sortableExtensions) Less(i, j int) bool { return this[i].field < this[j].field } + +func (this sortableExtensions) String() string { + sort.Sort(this) + ss := make([]string, len(this)) + for i := range this { + ss[i] = fmt.Sprintf("%d: %v", this[i].field, this[i].ext) + } + return "map[" + strings.Join(ss, ",") + "]" +} + +func StringFromInternalExtension(m extendableProto) string { + return StringFromExtensionsMap(m.extensionsWrite()) +} + +func StringFromExtensionsMap(m map[int32]Extension) string { + return newSortableExtensionsFromMap(m).String() +} + +func StringFromExtensionsBytes(ext []byte) string { + m, err := BytesToExtensionsMap(ext) + if err != nil { + panic(err) + } + return StringFromExtensionsMap(m) +} + +func EncodeInternalExtension(m extendableProto, data []byte) (n int, err error) { + return EncodeExtensionMap(m.extensionsWrite(), data) +} + +func EncodeExtensionMap(m map[int32]Extension, data []byte) (n int, err error) { + o := 0 + for _, e := range m { + if err := e.Encode(); err != nil { + return 0, err + } + n := copy(data[o:], e.enc) + if n != len(e.enc) { + return 0, io.ErrShortBuffer + } + o += n + } + return o, nil +} + +func GetRawExtension(m map[int32]Extension, id int32) ([]byte, error) { + e := m[id] + if err := e.Encode(); err != nil { + return nil, err + } + return e.enc, nil +} + +func size(buf []byte, wire int) (int, error) { + switch wire { + case WireVarint: + _, n := DecodeVarint(buf) + return n, nil + case WireFixed64: + return 8, nil + case WireBytes: + v, n := DecodeVarint(buf) + return int(v) + n, nil + case WireFixed32: + return 4, nil + case WireStartGroup: + offset := 0 + for { + u, n := DecodeVarint(buf[offset:]) + fwire := int(u & 0x7) + offset += n + if fwire == WireEndGroup { + return offset, nil + } + s, err := size(buf[offset:], wire) + if err != nil { + return 0, err + } + offset += s + } + } + return 0, fmt.Errorf("proto: can't get size for unknown wire type %d", wire) +} + +func BytesToExtensionsMap(buf []byte) (map[int32]Extension, error) { + m := make(map[int32]Extension) + i := 0 + for i < len(buf) { + tag, n := DecodeVarint(buf[i:]) + if n <= 0 { + return nil, fmt.Errorf("unable to decode varint") + } + fieldNum := int32(tag >> 3) + wireType := int(tag & 0x7) + l, err := size(buf[i+n:], wireType) + if err != nil { + return nil, err + } + end := i + int(l) + n + m[int32(fieldNum)] = Extension{enc: buf[i:end]} + i = end + } + return m, nil +} + +func NewExtension(e []byte) Extension { + ee := Extension{enc: make([]byte, len(e))} + copy(ee.enc, e) + return ee +} + +func AppendExtension(e Message, tag int32, buf []byte) { + if ee, eok := e.(extensionsBytes); eok { + ext := ee.GetExtensions() + *ext = append(*ext, buf...) + return + } + if ee, eok := e.(extendableProto); eok { + m := ee.extensionsWrite() + ext := m[int32(tag)] // may be missing + ext.enc = append(ext.enc, buf...) + m[int32(tag)] = ext + } +} + +func encodeExtension(extension *ExtensionDesc, value interface{}) ([]byte, error) { + u := getMarshalInfo(reflect.TypeOf(extension.ExtendedType)) + ei := u.getExtElemInfo(extension) + v := value + p := toAddrPointer(&v, ei.isptr) + siz := ei.sizer(p, SizeVarint(ei.wiretag)) + buf := make([]byte, 0, siz) + return ei.marshaler(buf, p, ei.wiretag, false) +} + +func decodeExtensionFromBytes(extension *ExtensionDesc, buf []byte) (interface{}, error) { + o := 0 + for o < len(buf) { + tag, n := DecodeVarint((buf)[o:]) + fieldNum := int32(tag >> 3) + wireType := int(tag & 0x7) + if o+n > len(buf) { + return nil, fmt.Errorf("unable to decode extension") + } + l, err := size((buf)[o+n:], wireType) + if err != nil { + return nil, err + } + if int32(fieldNum) == extension.Field { + if o+n+l > len(buf) { + return nil, fmt.Errorf("unable to decode extension") + } + v, err := decodeExtension((buf)[o:o+n+l], extension) + if err != nil { + return nil, err + } + return v, nil + } + o += n + l + } + return defaultExtensionValue(extension) +} + +func (this *Extension) Encode() error { + if this.enc == nil { + var err error + this.enc, err = encodeExtension(this.desc, this.value) + if err != nil { + return err + } + } + return nil +} + +func (this Extension) GoString() string { + if err := this.Encode(); err != nil { + return fmt.Sprintf("error encoding extension: %v", err) + } + return fmt.Sprintf("proto.NewExtension(%#v)", this.enc) +} + +func SetUnsafeExtension(pb Message, fieldNum int32, value interface{}) error { + typ := reflect.TypeOf(pb).Elem() + ext, ok := extensionMaps[typ] + if !ok { + return fmt.Errorf("proto: bad extended type; %s is not extendable", typ.String()) + } + desc, ok := ext[fieldNum] + if !ok { + return errors.New("proto: bad extension number; not in declared ranges") + } + return SetExtension(pb, desc, value) +} + +func GetUnsafeExtension(pb Message, fieldNum int32) (interface{}, error) { + typ := reflect.TypeOf(pb).Elem() + ext, ok := extensionMaps[typ] + if !ok { + return nil, fmt.Errorf("proto: bad extended type; %s is not extendable", typ.String()) + } + desc, ok := ext[fieldNum] + if !ok { + return nil, fmt.Errorf("unregistered field number %d", fieldNum) + } + return GetExtension(pb, desc) +} + +func NewUnsafeXXX_InternalExtensions(m map[int32]Extension) XXX_InternalExtensions { + x := &XXX_InternalExtensions{ + p: new(struct { + mu sync.Mutex + extensionMap map[int32]Extension + }), + } + x.p.extensionMap = m + return *x +} + +func GetUnsafeExtensionsMap(extendable Message) map[int32]Extension { + pb := extendable.(extendableProto) + return pb.extensionsWrite() +} + +func deleteExtension(pb extensionsBytes, theFieldNum int32, offset int) int { + ext := pb.GetExtensions() + for offset < len(*ext) { + tag, n1 := DecodeVarint((*ext)[offset:]) + fieldNum := int32(tag >> 3) + wireType := int(tag & 0x7) + n2, err := size((*ext)[offset+n1:], wireType) + if err != nil { + panic(err) + } + newOffset := offset + n1 + n2 + if fieldNum == theFieldNum { + *ext = append((*ext)[:offset], (*ext)[newOffset:]...) + return offset + } + offset = newOffset + } + return -1 +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/lib.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/lib.go new file mode 100644 index 000000000000..0f1950c67e48 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/lib.go @@ -0,0 +1,921 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +/* +Package proto converts data structures to and from the wire format of +protocol buffers. It works in concert with the Go source code generated +for .proto files by the protocol compiler. + +A summary of the properties of the protocol buffer interface +for a protocol buffer variable v: + + - Names are turned from camel_case to CamelCase for export. + - There are no methods on v to set fields; just treat + them as structure fields. + - There are getters that return a field's value if set, + and return the field's default value if unset. + The getters work even if the receiver is a nil message. + - The zero value for a struct is its correct initialization state. + All desired fields must be set before marshaling. + - A Reset() method will restore a protobuf struct to its zero state. + - Non-repeated fields are pointers to the values; nil means unset. + That is, optional or required field int32 f becomes F *int32. + - Repeated fields are slices. + - Helper functions are available to aid the setting of fields. + msg.Foo = proto.String("hello") // set field + - Constants are defined to hold the default values of all fields that + have them. They have the form Default_StructName_FieldName. + Because the getter methods handle defaulted values, + direct use of these constants should be rare. + - Enums are given type names and maps from names to values. + Enum values are prefixed by the enclosing message's name, or by the + enum's type name if it is a top-level enum. Enum types have a String + method, and a Enum method to assist in message construction. + - Nested messages, groups and enums have type names prefixed with the name of + the surrounding message type. + - Extensions are given descriptor names that start with E_, + followed by an underscore-delimited list of the nested messages + that contain it (if any) followed by the CamelCased name of the + extension field itself. HasExtension, ClearExtension, GetExtension + and SetExtension are functions for manipulating extensions. + - Oneof field sets are given a single field in their message, + with distinguished wrapper types for each possible field value. + - Marshal and Unmarshal are functions to encode and decode the wire format. + +When the .proto file specifies `syntax="proto3"`, there are some differences: + + - Non-repeated fields of non-message type are values instead of pointers. + - Enum types do not get an Enum method. + +The simplest way to describe this is to see an example. +Given file test.proto, containing + + package example; + + enum FOO { X = 17; } + + message Test { + required string label = 1; + optional int32 type = 2 [default=77]; + repeated int64 reps = 3; + optional group OptionalGroup = 4 { + required string RequiredField = 5; + } + oneof union { + int32 number = 6; + string name = 7; + } + } + +The resulting file, test.pb.go, is: + + package example + + import proto "github.com/gogo/protobuf/proto" + import math "math" + + type FOO int32 + const ( + FOO_X FOO = 17 + ) + var FOO_name = map[int32]string{ + 17: "X", + } + var FOO_value = map[string]int32{ + "X": 17, + } + + func (x FOO) Enum() *FOO { + p := new(FOO) + *p = x + return p + } + func (x FOO) String() string { + return proto.EnumName(FOO_name, int32(x)) + } + func (x *FOO) UnmarshalJSON(data []byte) error { + value, err := proto.UnmarshalJSONEnum(FOO_value, data) + if err != nil { + return err + } + *x = FOO(value) + return nil + } + + type Test struct { + Label *string `protobuf:"bytes,1,req,name=label" json:"label,omitempty"` + Type *int32 `protobuf:"varint,2,opt,name=type,def=77" json:"type,omitempty"` + Reps []int64 `protobuf:"varint,3,rep,name=reps" json:"reps,omitempty"` + Optionalgroup *Test_OptionalGroup `protobuf:"group,4,opt,name=OptionalGroup" json:"optionalgroup,omitempty"` + // Types that are valid to be assigned to Union: + // *Test_Number + // *Test_Name + Union isTest_Union `protobuf_oneof:"union"` + XXX_unrecognized []byte `json:"-"` + } + func (m *Test) Reset() { *m = Test{} } + func (m *Test) String() string { return proto.CompactTextString(m) } + func (*Test) ProtoMessage() {} + + type isTest_Union interface { + isTest_Union() + } + + type Test_Number struct { + Number int32 `protobuf:"varint,6,opt,name=number"` + } + type Test_Name struct { + Name string `protobuf:"bytes,7,opt,name=name"` + } + + func (*Test_Number) isTest_Union() {} + func (*Test_Name) isTest_Union() {} + + func (m *Test) GetUnion() isTest_Union { + if m != nil { + return m.Union + } + return nil + } + const Default_Test_Type int32 = 77 + + func (m *Test) GetLabel() string { + if m != nil && m.Label != nil { + return *m.Label + } + return "" + } + + func (m *Test) GetType() int32 { + if m != nil && m.Type != nil { + return *m.Type + } + return Default_Test_Type + } + + func (m *Test) GetOptionalgroup() *Test_OptionalGroup { + if m != nil { + return m.Optionalgroup + } + return nil + } + + type Test_OptionalGroup struct { + RequiredField *string `protobuf:"bytes,5,req" json:"RequiredField,omitempty"` + } + func (m *Test_OptionalGroup) Reset() { *m = Test_OptionalGroup{} } + func (m *Test_OptionalGroup) String() string { return proto.CompactTextString(m) } + + func (m *Test_OptionalGroup) GetRequiredField() string { + if m != nil && m.RequiredField != nil { + return *m.RequiredField + } + return "" + } + + func (m *Test) GetNumber() int32 { + if x, ok := m.GetUnion().(*Test_Number); ok { + return x.Number + } + return 0 + } + + func (m *Test) GetName() string { + if x, ok := m.GetUnion().(*Test_Name); ok { + return x.Name + } + return "" + } + + func init() { + proto.RegisterEnum("example.FOO", FOO_name, FOO_value) + } + +To create and play with a Test object: + + package main + + import ( + "log" + + "github.com/gogo/protobuf/proto" + pb "./example.pb" + ) + + func main() { + test := &pb.Test{ + Label: proto.String("hello"), + Type: proto.Int32(17), + Reps: []int64{1, 2, 3}, + Optionalgroup: &pb.Test_OptionalGroup{ + RequiredField: proto.String("good bye"), + }, + Union: &pb.Test_Name{"fred"}, + } + data, err := proto.Marshal(test) + if err != nil { + log.Fatal("marshaling error: ", err) + } + newTest := &pb.Test{} + err = proto.Unmarshal(data, newTest) + if err != nil { + log.Fatal("unmarshaling error: ", err) + } + // Now test and newTest contain the same data. + if test.GetLabel() != newTest.GetLabel() { + log.Fatalf("data mismatch %q != %q", test.GetLabel(), newTest.GetLabel()) + } + // Use a type switch to determine which oneof was set. + switch u := test.Union.(type) { + case *pb.Test_Number: // u.Number contains the number. + case *pb.Test_Name: // u.Name contains the string. + } + // etc. + } +*/ +package proto + +import ( + "encoding/json" + "errors" + "fmt" + "log" + "reflect" + "sort" + "strconv" + "sync" +) + +var errInvalidUTF8 = errors.New("proto: invalid UTF-8 string") + +// Message is implemented by generated protocol buffer messages. +type Message interface { + Reset() + String() string + ProtoMessage() +} + +// Stats records allocation details about the protocol buffer encoders +// and decoders. Useful for tuning the library itself. +type Stats struct { + Emalloc uint64 // mallocs in encode + Dmalloc uint64 // mallocs in decode + Encode uint64 // number of encodes + Decode uint64 // number of decodes + Chit uint64 // number of cache hits + Cmiss uint64 // number of cache misses + Size uint64 // number of sizes +} + +// Set to true to enable stats collection. +const collectStats = false + +var stats Stats + +// GetStats returns a copy of the global Stats structure. +func GetStats() Stats { return stats } + +// A Buffer is a buffer manager for marshaling and unmarshaling +// protocol buffers. It may be reused between invocations to +// reduce memory usage. It is not necessary to use a Buffer; +// the global functions Marshal and Unmarshal create a +// temporary Buffer and are fine for most applications. +type Buffer struct { + buf []byte // encode/decode byte stream + index int // read point + + deterministic bool +} + +// NewBuffer allocates a new Buffer and initializes its internal data to +// the contents of the argument slice. +func NewBuffer(e []byte) *Buffer { + return &Buffer{buf: e} +} + +// Reset resets the Buffer, ready for marshaling a new protocol buffer. +func (p *Buffer) Reset() { + p.buf = p.buf[0:0] // for reading/writing + p.index = 0 // for reading +} + +// SetBuf replaces the internal buffer with the slice, +// ready for unmarshaling the contents of the slice. +func (p *Buffer) SetBuf(s []byte) { + p.buf = s + p.index = 0 +} + +// Bytes returns the contents of the Buffer. +func (p *Buffer) Bytes() []byte { return p.buf } + +// SetDeterministic sets whether to use deterministic serialization. +// +// Deterministic serialization guarantees that for a given binary, equal +// messages will always be serialized to the same bytes. This implies: +// +// - Repeated serialization of a message will return the same bytes. +// - Different processes of the same binary (which may be executing on +// different machines) will serialize equal messages to the same bytes. +// +// Note that the deterministic serialization is NOT canonical across +// languages. It is not guaranteed to remain stable over time. It is unstable +// across different builds with schema changes due to unknown fields. +// Users who need canonical serialization (e.g., persistent storage in a +// canonical form, fingerprinting, etc.) should define their own +// canonicalization specification and implement their own serializer rather +// than relying on this API. +// +// If deterministic serialization is requested, map entries will be sorted +// by keys in lexographical order. This is an implementation detail and +// subject to change. +func (p *Buffer) SetDeterministic(deterministic bool) { + p.deterministic = deterministic +} + +/* + * Helper routines for simplifying the creation of optional fields of basic type. + */ + +// Bool is a helper routine that allocates a new bool value +// to store v and returns a pointer to it. +func Bool(v bool) *bool { + return &v +} + +// Int32 is a helper routine that allocates a new int32 value +// to store v and returns a pointer to it. +func Int32(v int32) *int32 { + return &v +} + +// Int is a helper routine that allocates a new int32 value +// to store v and returns a pointer to it, but unlike Int32 +// its argument value is an int. +func Int(v int) *int32 { + p := new(int32) + *p = int32(v) + return p +} + +// Int64 is a helper routine that allocates a new int64 value +// to store v and returns a pointer to it. +func Int64(v int64) *int64 { + return &v +} + +// Float32 is a helper routine that allocates a new float32 value +// to store v and returns a pointer to it. +func Float32(v float32) *float32 { + return &v +} + +// Float64 is a helper routine that allocates a new float64 value +// to store v and returns a pointer to it. +func Float64(v float64) *float64 { + return &v +} + +// Uint32 is a helper routine that allocates a new uint32 value +// to store v and returns a pointer to it. +func Uint32(v uint32) *uint32 { + return &v +} + +// Uint64 is a helper routine that allocates a new uint64 value +// to store v and returns a pointer to it. +func Uint64(v uint64) *uint64 { + return &v +} + +// String is a helper routine that allocates a new string value +// to store v and returns a pointer to it. +func String(v string) *string { + return &v +} + +// EnumName is a helper function to simplify printing protocol buffer enums +// by name. Given an enum map and a value, it returns a useful string. +func EnumName(m map[int32]string, v int32) string { + s, ok := m[v] + if ok { + return s + } + return strconv.Itoa(int(v)) +} + +// UnmarshalJSONEnum is a helper function to simplify recovering enum int values +// from their JSON-encoded representation. Given a map from the enum's symbolic +// names to its int values, and a byte buffer containing the JSON-encoded +// value, it returns an int32 that can be cast to the enum type by the caller. +// +// The function can deal with both JSON representations, numeric and symbolic. +func UnmarshalJSONEnum(m map[string]int32, data []byte, enumName string) (int32, error) { + if data[0] == '"' { + // New style: enums are strings. + var repr string + if err := json.Unmarshal(data, &repr); err != nil { + return -1, err + } + val, ok := m[repr] + if !ok { + return 0, fmt.Errorf("unrecognized enum %s value %q", enumName, repr) + } + return val, nil + } + // Old style: enums are ints. + var val int32 + if err := json.Unmarshal(data, &val); err != nil { + return 0, fmt.Errorf("cannot unmarshal %#q into enum %s", data, enumName) + } + return val, nil +} + +// DebugPrint dumps the encoded data in b in a debugging format with a header +// including the string s. Used in testing but made available for general debugging. +func (p *Buffer) DebugPrint(s string, b []byte) { + var u uint64 + + obuf := p.buf + sindex := p.index + p.buf = b + p.index = 0 + depth := 0 + + fmt.Printf("\n--- %s ---\n", s) + +out: + for { + for i := 0; i < depth; i++ { + fmt.Print(" ") + } + + index := p.index + if index == len(p.buf) { + break + } + + op, err := p.DecodeVarint() + if err != nil { + fmt.Printf("%3d: fetching op err %v\n", index, err) + break out + } + tag := op >> 3 + wire := op & 7 + + switch wire { + default: + fmt.Printf("%3d: t=%3d unknown wire=%d\n", + index, tag, wire) + break out + + case WireBytes: + var r []byte + + r, err = p.DecodeRawBytes(false) + if err != nil { + break out + } + fmt.Printf("%3d: t=%3d bytes [%d]", index, tag, len(r)) + if len(r) <= 6 { + for i := 0; i < len(r); i++ { + fmt.Printf(" %.2x", r[i]) + } + } else { + for i := 0; i < 3; i++ { + fmt.Printf(" %.2x", r[i]) + } + fmt.Printf(" ..") + for i := len(r) - 3; i < len(r); i++ { + fmt.Printf(" %.2x", r[i]) + } + } + fmt.Printf("\n") + + case WireFixed32: + u, err = p.DecodeFixed32() + if err != nil { + fmt.Printf("%3d: t=%3d fix32 err %v\n", index, tag, err) + break out + } + fmt.Printf("%3d: t=%3d fix32 %d\n", index, tag, u) + + case WireFixed64: + u, err = p.DecodeFixed64() + if err != nil { + fmt.Printf("%3d: t=%3d fix64 err %v\n", index, tag, err) + break out + } + fmt.Printf("%3d: t=%3d fix64 %d\n", index, tag, u) + + case WireVarint: + u, err = p.DecodeVarint() + if err != nil { + fmt.Printf("%3d: t=%3d varint err %v\n", index, tag, err) + break out + } + fmt.Printf("%3d: t=%3d varint %d\n", index, tag, u) + + case WireStartGroup: + fmt.Printf("%3d: t=%3d start\n", index, tag) + depth++ + + case WireEndGroup: + depth-- + fmt.Printf("%3d: t=%3d end\n", index, tag) + } + } + + if depth != 0 { + fmt.Printf("%3d: start-end not balanced %d\n", p.index, depth) + } + fmt.Printf("\n") + + p.buf = obuf + p.index = sindex +} + +// SetDefaults sets unset protocol buffer fields to their default values. +// It only modifies fields that are both unset and have defined defaults. +// It recursively sets default values in any non-nil sub-messages. +func SetDefaults(pb Message) { + setDefaults(reflect.ValueOf(pb), true, false) +} + +// v is a pointer to a struct. +func setDefaults(v reflect.Value, recur, zeros bool) { + v = v.Elem() + + defaultMu.RLock() + dm, ok := defaults[v.Type()] + defaultMu.RUnlock() + if !ok { + dm = buildDefaultMessage(v.Type()) + defaultMu.Lock() + defaults[v.Type()] = dm + defaultMu.Unlock() + } + + for _, sf := range dm.scalars { + f := v.Field(sf.index) + if !f.IsNil() { + // field already set + continue + } + dv := sf.value + if dv == nil && !zeros { + // no explicit default, and don't want to set zeros + continue + } + fptr := f.Addr().Interface() // **T + // TODO: Consider batching the allocations we do here. + switch sf.kind { + case reflect.Bool: + b := new(bool) + if dv != nil { + *b = dv.(bool) + } + *(fptr.(**bool)) = b + case reflect.Float32: + f := new(float32) + if dv != nil { + *f = dv.(float32) + } + *(fptr.(**float32)) = f + case reflect.Float64: + f := new(float64) + if dv != nil { + *f = dv.(float64) + } + *(fptr.(**float64)) = f + case reflect.Int32: + // might be an enum + if ft := f.Type(); ft != int32PtrType { + // enum + f.Set(reflect.New(ft.Elem())) + if dv != nil { + f.Elem().SetInt(int64(dv.(int32))) + } + } else { + // int32 field + i := new(int32) + if dv != nil { + *i = dv.(int32) + } + *(fptr.(**int32)) = i + } + case reflect.Int64: + i := new(int64) + if dv != nil { + *i = dv.(int64) + } + *(fptr.(**int64)) = i + case reflect.String: + s := new(string) + if dv != nil { + *s = dv.(string) + } + *(fptr.(**string)) = s + case reflect.Uint8: + // exceptional case: []byte + var b []byte + if dv != nil { + db := dv.([]byte) + b = make([]byte, len(db)) + copy(b, db) + } else { + b = []byte{} + } + *(fptr.(*[]byte)) = b + case reflect.Uint32: + u := new(uint32) + if dv != nil { + *u = dv.(uint32) + } + *(fptr.(**uint32)) = u + case reflect.Uint64: + u := new(uint64) + if dv != nil { + *u = dv.(uint64) + } + *(fptr.(**uint64)) = u + default: + log.Printf("proto: can't set default for field %v (sf.kind=%v)", f, sf.kind) + } + } + + for _, ni := range dm.nested { + f := v.Field(ni) + // f is *T or []*T or map[T]*T + switch f.Kind() { + case reflect.Ptr: + if f.IsNil() { + continue + } + setDefaults(f, recur, zeros) + + case reflect.Slice: + for i := 0; i < f.Len(); i++ { + e := f.Index(i) + if e.IsNil() { + continue + } + setDefaults(e, recur, zeros) + } + + case reflect.Map: + for _, k := range f.MapKeys() { + e := f.MapIndex(k) + if e.IsNil() { + continue + } + setDefaults(e, recur, zeros) + } + } + } +} + +var ( + // defaults maps a protocol buffer struct type to a slice of the fields, + // with its scalar fields set to their proto-declared non-zero default values. + defaultMu sync.RWMutex + defaults = make(map[reflect.Type]defaultMessage) + + int32PtrType = reflect.TypeOf((*int32)(nil)) +) + +// defaultMessage represents information about the default values of a message. +type defaultMessage struct { + scalars []scalarField + nested []int // struct field index of nested messages +} + +type scalarField struct { + index int // struct field index + kind reflect.Kind // element type (the T in *T or []T) + value interface{} // the proto-declared default value, or nil +} + +// t is a struct type. +func buildDefaultMessage(t reflect.Type) (dm defaultMessage) { + sprop := GetProperties(t) + for _, prop := range sprop.Prop { + fi, ok := sprop.decoderTags.get(prop.Tag) + if !ok { + // XXX_unrecognized + continue + } + ft := t.Field(fi).Type + + sf, nested, err := fieldDefault(ft, prop) + switch { + case err != nil: + log.Print(err) + case nested: + dm.nested = append(dm.nested, fi) + case sf != nil: + sf.index = fi + dm.scalars = append(dm.scalars, *sf) + } + } + + return dm +} + +// fieldDefault returns the scalarField for field type ft. +// sf will be nil if the field can not have a default. +// nestedMessage will be true if this is a nested message. +// Note that sf.index is not set on return. +func fieldDefault(ft reflect.Type, prop *Properties) (sf *scalarField, nestedMessage bool, err error) { + var canHaveDefault bool + switch ft.Kind() { + case reflect.Ptr: + if ft.Elem().Kind() == reflect.Struct { + nestedMessage = true + } else { + canHaveDefault = true // proto2 scalar field + } + + case reflect.Slice: + switch ft.Elem().Kind() { + case reflect.Ptr: + nestedMessage = true // repeated message + case reflect.Uint8: + canHaveDefault = true // bytes field + } + + case reflect.Map: + if ft.Elem().Kind() == reflect.Ptr { + nestedMessage = true // map with message values + } + } + + if !canHaveDefault { + if nestedMessage { + return nil, true, nil + } + return nil, false, nil + } + + // We now know that ft is a pointer or slice. + sf = &scalarField{kind: ft.Elem().Kind()} + + // scalar fields without defaults + if !prop.HasDefault { + return sf, false, nil + } + + // a scalar field: either *T or []byte + switch ft.Elem().Kind() { + case reflect.Bool: + x, err := strconv.ParseBool(prop.Default) + if err != nil { + return nil, false, fmt.Errorf("proto: bad default bool %q: %v", prop.Default, err) + } + sf.value = x + case reflect.Float32: + x, err := strconv.ParseFloat(prop.Default, 32) + if err != nil { + return nil, false, fmt.Errorf("proto: bad default float32 %q: %v", prop.Default, err) + } + sf.value = float32(x) + case reflect.Float64: + x, err := strconv.ParseFloat(prop.Default, 64) + if err != nil { + return nil, false, fmt.Errorf("proto: bad default float64 %q: %v", prop.Default, err) + } + sf.value = x + case reflect.Int32: + x, err := strconv.ParseInt(prop.Default, 10, 32) + if err != nil { + return nil, false, fmt.Errorf("proto: bad default int32 %q: %v", prop.Default, err) + } + sf.value = int32(x) + case reflect.Int64: + x, err := strconv.ParseInt(prop.Default, 10, 64) + if err != nil { + return nil, false, fmt.Errorf("proto: bad default int64 %q: %v", prop.Default, err) + } + sf.value = x + case reflect.String: + sf.value = prop.Default + case reflect.Uint8: + // []byte (not *uint8) + sf.value = []byte(prop.Default) + case reflect.Uint32: + x, err := strconv.ParseUint(prop.Default, 10, 32) + if err != nil { + return nil, false, fmt.Errorf("proto: bad default uint32 %q: %v", prop.Default, err) + } + sf.value = uint32(x) + case reflect.Uint64: + x, err := strconv.ParseUint(prop.Default, 10, 64) + if err != nil { + return nil, false, fmt.Errorf("proto: bad default uint64 %q: %v", prop.Default, err) + } + sf.value = x + default: + return nil, false, fmt.Errorf("proto: unhandled def kind %v", ft.Elem().Kind()) + } + + return sf, false, nil +} + +// mapKeys returns a sort.Interface to be used for sorting the map keys. +// Map fields may have key types of non-float scalars, strings and enums. +func mapKeys(vs []reflect.Value) sort.Interface { + s := mapKeySorter{vs: vs} + + // Type specialization per https://developers.google.com/protocol-buffers/docs/proto#maps. + if len(vs) == 0 { + return s + } + switch vs[0].Kind() { + case reflect.Int32, reflect.Int64: + s.less = func(a, b reflect.Value) bool { return a.Int() < b.Int() } + case reflect.Uint32, reflect.Uint64: + s.less = func(a, b reflect.Value) bool { return a.Uint() < b.Uint() } + case reflect.Bool: + s.less = func(a, b reflect.Value) bool { return !a.Bool() && b.Bool() } // false < true + case reflect.String: + s.less = func(a, b reflect.Value) bool { return a.String() < b.String() } + default: + panic(fmt.Sprintf("unsupported map key type: %v", vs[0].Kind())) + } + + return s +} + +type mapKeySorter struct { + vs []reflect.Value + less func(a, b reflect.Value) bool +} + +func (s mapKeySorter) Len() int { return len(s.vs) } +func (s mapKeySorter) Swap(i, j int) { s.vs[i], s.vs[j] = s.vs[j], s.vs[i] } +func (s mapKeySorter) Less(i, j int) bool { + return s.less(s.vs[i], s.vs[j]) +} + +// isProto3Zero reports whether v is a zero proto3 value. +func isProto3Zero(v reflect.Value) bool { + switch v.Kind() { + case reflect.Bool: + return !v.Bool() + case reflect.Int32, reflect.Int64: + return v.Int() == 0 + case reflect.Uint32, reflect.Uint64: + return v.Uint() == 0 + case reflect.Float32, reflect.Float64: + return v.Float() == 0 + case reflect.String: + return v.String() == "" + } + return false +} + +// ProtoPackageIsVersion2 is referenced from generated protocol buffer files +// to assert that that code is compatible with this version of the proto package. +const GoGoProtoPackageIsVersion2 = true + +// ProtoPackageIsVersion1 is referenced from generated protocol buffer files +// to assert that that code is compatible with this version of the proto package. +const GoGoProtoPackageIsVersion1 = true + +// InternalMessageInfo is a type used internally by generated .pb.go files. +// This type is not intended to be used by non-generated code. +// This type is not subject to any compatibility guarantee. +type InternalMessageInfo struct { + marshal *marshalInfo + unmarshal *unmarshalInfo + merge *mergeInfo + discard *discardInfo +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/lib_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/lib_gogo.go new file mode 100644 index 000000000000..b3aa39190a13 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/lib_gogo.go @@ -0,0 +1,50 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2013, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "encoding/json" + "strconv" +) + +type Sizer interface { + Size() int +} + +type ProtoSizer interface { + ProtoSize() int +} + +func MarshalJSONEnum(m map[int32]string, value int32) ([]byte, error) { + s, ok := m[value] + if !ok { + s = strconv.Itoa(int(value)) + } + return json.Marshal(s) +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/message_set.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/message_set.go new file mode 100644 index 000000000000..3b6ca41d5e55 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/message_set.go @@ -0,0 +1,314 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +/* + * Support for message sets. + */ + +import ( + "bytes" + "encoding/json" + "errors" + "fmt" + "reflect" + "sort" + "sync" +) + +// errNoMessageTypeID occurs when a protocol buffer does not have a message type ID. +// A message type ID is required for storing a protocol buffer in a message set. +var errNoMessageTypeID = errors.New("proto does not have a message type ID") + +// The first two types (_MessageSet_Item and messageSet) +// model what the protocol compiler produces for the following protocol message: +// message MessageSet { +// repeated group Item = 1 { +// required int32 type_id = 2; +// required string message = 3; +// }; +// } +// That is the MessageSet wire format. We can't use a proto to generate these +// because that would introduce a circular dependency between it and this package. + +type _MessageSet_Item struct { + TypeId *int32 `protobuf:"varint,2,req,name=type_id"` + Message []byte `protobuf:"bytes,3,req,name=message"` +} + +type messageSet struct { + Item []*_MessageSet_Item `protobuf:"group,1,rep"` + XXX_unrecognized []byte + // TODO: caching? +} + +// Make sure messageSet is a Message. +var _ Message = (*messageSet)(nil) + +// messageTypeIder is an interface satisfied by a protocol buffer type +// that may be stored in a MessageSet. +type messageTypeIder interface { + MessageTypeId() int32 +} + +func (ms *messageSet) find(pb Message) *_MessageSet_Item { + mti, ok := pb.(messageTypeIder) + if !ok { + return nil + } + id := mti.MessageTypeId() + for _, item := range ms.Item { + if *item.TypeId == id { + return item + } + } + return nil +} + +func (ms *messageSet) Has(pb Message) bool { + return ms.find(pb) != nil +} + +func (ms *messageSet) Unmarshal(pb Message) error { + if item := ms.find(pb); item != nil { + return Unmarshal(item.Message, pb) + } + if _, ok := pb.(messageTypeIder); !ok { + return errNoMessageTypeID + } + return nil // TODO: return error instead? +} + +func (ms *messageSet) Marshal(pb Message) error { + msg, err := Marshal(pb) + if err != nil { + return err + } + if item := ms.find(pb); item != nil { + // reuse existing item + item.Message = msg + return nil + } + + mti, ok := pb.(messageTypeIder) + if !ok { + return errNoMessageTypeID + } + + mtid := mti.MessageTypeId() + ms.Item = append(ms.Item, &_MessageSet_Item{ + TypeId: &mtid, + Message: msg, + }) + return nil +} + +func (ms *messageSet) Reset() { *ms = messageSet{} } +func (ms *messageSet) String() string { return CompactTextString(ms) } +func (*messageSet) ProtoMessage() {} + +// Support for the message_set_wire_format message option. + +func skipVarint(buf []byte) []byte { + i := 0 + for ; buf[i]&0x80 != 0; i++ { + } + return buf[i+1:] +} + +// MarshalMessageSet encodes the extension map represented by m in the message set wire format. +// It is called by generated Marshal methods on protocol buffer messages with the message_set_wire_format option. +func MarshalMessageSet(exts interface{}) ([]byte, error) { + return marshalMessageSet(exts, false) +} + +// marshaMessageSet implements above function, with the opt to turn on / off deterministic during Marshal. +func marshalMessageSet(exts interface{}, deterministic bool) ([]byte, error) { + switch exts := exts.(type) { + case *XXX_InternalExtensions: + var u marshalInfo + siz := u.sizeMessageSet(exts) + b := make([]byte, 0, siz) + return u.appendMessageSet(b, exts, deterministic) + + case map[int32]Extension: + // This is an old-style extension map. + // Wrap it in a new-style XXX_InternalExtensions. + ie := XXX_InternalExtensions{ + p: &struct { + mu sync.Mutex + extensionMap map[int32]Extension + }{ + extensionMap: exts, + }, + } + + var u marshalInfo + siz := u.sizeMessageSet(&ie) + b := make([]byte, 0, siz) + return u.appendMessageSet(b, &ie, deterministic) + + default: + return nil, errors.New("proto: not an extension map") + } +} + +// UnmarshalMessageSet decodes the extension map encoded in buf in the message set wire format. +// It is called by Unmarshal methods on protocol buffer messages with the message_set_wire_format option. +func UnmarshalMessageSet(buf []byte, exts interface{}) error { + var m map[int32]Extension + switch exts := exts.(type) { + case *XXX_InternalExtensions: + m = exts.extensionsWrite() + case map[int32]Extension: + m = exts + default: + return errors.New("proto: not an extension map") + } + + ms := new(messageSet) + if err := Unmarshal(buf, ms); err != nil { + return err + } + for _, item := range ms.Item { + id := *item.TypeId + msg := item.Message + + // Restore wire type and field number varint, plus length varint. + // Be careful to preserve duplicate items. + b := EncodeVarint(uint64(id)<<3 | WireBytes) + if ext, ok := m[id]; ok { + // Existing data; rip off the tag and length varint + // so we join the new data correctly. + // We can assume that ext.enc is set because we are unmarshaling. + o := ext.enc[len(b):] // skip wire type and field number + _, n := DecodeVarint(o) // calculate length of length varint + o = o[n:] // skip length varint + msg = append(o, msg...) // join old data and new data + } + b = append(b, EncodeVarint(uint64(len(msg)))...) + b = append(b, msg...) + + m[id] = Extension{enc: b} + } + return nil +} + +// MarshalMessageSetJSON encodes the extension map represented by m in JSON format. +// It is called by generated MarshalJSON methods on protocol buffer messages with the message_set_wire_format option. +func MarshalMessageSetJSON(exts interface{}) ([]byte, error) { + var m map[int32]Extension + switch exts := exts.(type) { + case *XXX_InternalExtensions: + var mu sync.Locker + m, mu = exts.extensionsRead() + if m != nil { + // Keep the extensions map locked until we're done marshaling to prevent + // races between marshaling and unmarshaling the lazily-{en,de}coded + // values. + mu.Lock() + defer mu.Unlock() + } + case map[int32]Extension: + m = exts + default: + return nil, errors.New("proto: not an extension map") + } + var b bytes.Buffer + b.WriteByte('{') + + // Process the map in key order for deterministic output. + ids := make([]int32, 0, len(m)) + for id := range m { + ids = append(ids, id) + } + sort.Sort(int32Slice(ids)) // int32Slice defined in text.go + + for i, id := range ids { + ext := m[id] + msd, ok := messageSetMap[id] + if !ok { + // Unknown type; we can't render it, so skip it. + continue + } + + if i > 0 && b.Len() > 1 { + b.WriteByte(',') + } + + fmt.Fprintf(&b, `"[%s]":`, msd.name) + + x := ext.value + if x == nil { + x = reflect.New(msd.t.Elem()).Interface() + if err := Unmarshal(ext.enc, x.(Message)); err != nil { + return nil, err + } + } + d, err := json.Marshal(x) + if err != nil { + return nil, err + } + b.Write(d) + } + b.WriteByte('}') + return b.Bytes(), nil +} + +// UnmarshalMessageSetJSON decodes the extension map encoded in buf in JSON format. +// It is called by generated UnmarshalJSON methods on protocol buffer messages with the message_set_wire_format option. +func UnmarshalMessageSetJSON(buf []byte, exts interface{}) error { + // Common-case fast path. + if len(buf) == 0 || bytes.Equal(buf, []byte("{}")) { + return nil + } + + // This is fairly tricky, and it's not clear that it is needed. + return errors.New("TODO: UnmarshalMessageSetJSON not yet implemented") +} + +// A global registry of types that can be used in a MessageSet. + +var messageSetMap = make(map[int32]messageSetDesc) + +type messageSetDesc struct { + t reflect.Type // pointer to struct + name string +} + +// RegisterMessageSetType is called from the generated code. +func RegisterMessageSetType(m Message, fieldNum int32, name string) { + messageSetMap[fieldNum] = messageSetDesc{ + t: reflect.TypeOf(m), + name: name, + } +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_reflect.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_reflect.go new file mode 100644 index 000000000000..b6cad90834b3 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_reflect.go @@ -0,0 +1,357 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2012 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// +build purego appengine js + +// This file contains an implementation of proto field accesses using package reflect. +// It is slower than the code in pointer_unsafe.go but it avoids package unsafe and can +// be used on App Engine. + +package proto + +import ( + "reflect" + "sync" +) + +const unsafeAllowed = false + +// A field identifies a field in a struct, accessible from a pointer. +// In this implementation, a field is identified by the sequence of field indices +// passed to reflect's FieldByIndex. +type field []int + +// toField returns a field equivalent to the given reflect field. +func toField(f *reflect.StructField) field { + return f.Index +} + +// invalidField is an invalid field identifier. +var invalidField = field(nil) + +// zeroField is a noop when calling pointer.offset. +var zeroField = field([]int{}) + +// IsValid reports whether the field identifier is valid. +func (f field) IsValid() bool { return f != nil } + +// The pointer type is for the table-driven decoder. +// The implementation here uses a reflect.Value of pointer type to +// create a generic pointer. In pointer_unsafe.go we use unsafe +// instead of reflect to implement the same (but faster) interface. +type pointer struct { + v reflect.Value +} + +// toPointer converts an interface of pointer type to a pointer +// that points to the same target. +func toPointer(i *Message) pointer { + return pointer{v: reflect.ValueOf(*i)} +} + +// toAddrPointer converts an interface to a pointer that points to +// the interface data. +func toAddrPointer(i *interface{}, isptr bool) pointer { + v := reflect.ValueOf(*i) + u := reflect.New(v.Type()) + u.Elem().Set(v) + return pointer{v: u} +} + +// valToPointer converts v to a pointer. v must be of pointer type. +func valToPointer(v reflect.Value) pointer { + return pointer{v: v} +} + +// offset converts from a pointer to a structure to a pointer to +// one of its fields. +func (p pointer) offset(f field) pointer { + return pointer{v: p.v.Elem().FieldByIndex(f).Addr()} +} + +func (p pointer) isNil() bool { + return p.v.IsNil() +} + +// grow updates the slice s in place to make it one element longer. +// s must be addressable. +// Returns the (addressable) new element. +func grow(s reflect.Value) reflect.Value { + n, m := s.Len(), s.Cap() + if n < m { + s.SetLen(n + 1) + } else { + s.Set(reflect.Append(s, reflect.Zero(s.Type().Elem()))) + } + return s.Index(n) +} + +func (p pointer) toInt64() *int64 { + return p.v.Interface().(*int64) +} +func (p pointer) toInt64Ptr() **int64 { + return p.v.Interface().(**int64) +} +func (p pointer) toInt64Slice() *[]int64 { + return p.v.Interface().(*[]int64) +} + +var int32ptr = reflect.TypeOf((*int32)(nil)) + +func (p pointer) toInt32() *int32 { + return p.v.Convert(int32ptr).Interface().(*int32) +} + +// The toInt32Ptr/Slice methods don't work because of enums. +// Instead, we must use set/get methods for the int32ptr/slice case. +/* + func (p pointer) toInt32Ptr() **int32 { + return p.v.Interface().(**int32) +} + func (p pointer) toInt32Slice() *[]int32 { + return p.v.Interface().(*[]int32) +} +*/ +func (p pointer) getInt32Ptr() *int32 { + if p.v.Type().Elem().Elem() == reflect.TypeOf(int32(0)) { + // raw int32 type + return p.v.Elem().Interface().(*int32) + } + // an enum + return p.v.Elem().Convert(int32PtrType).Interface().(*int32) +} +func (p pointer) setInt32Ptr(v int32) { + // Allocate value in a *int32. Possibly convert that to a *enum. + // Then assign it to a **int32 or **enum. + // Note: we can convert *int32 to *enum, but we can't convert + // **int32 to **enum! + p.v.Elem().Set(reflect.ValueOf(&v).Convert(p.v.Type().Elem())) +} + +// getInt32Slice copies []int32 from p as a new slice. +// This behavior differs from the implementation in pointer_unsafe.go. +func (p pointer) getInt32Slice() []int32 { + if p.v.Type().Elem().Elem() == reflect.TypeOf(int32(0)) { + // raw int32 type + return p.v.Elem().Interface().([]int32) + } + // an enum + // Allocate a []int32, then assign []enum's values into it. + // Note: we can't convert []enum to []int32. + slice := p.v.Elem() + s := make([]int32, slice.Len()) + for i := 0; i < slice.Len(); i++ { + s[i] = int32(slice.Index(i).Int()) + } + return s +} + +// setInt32Slice copies []int32 into p as a new slice. +// This behavior differs from the implementation in pointer_unsafe.go. +func (p pointer) setInt32Slice(v []int32) { + if p.v.Type().Elem().Elem() == reflect.TypeOf(int32(0)) { + // raw int32 type + p.v.Elem().Set(reflect.ValueOf(v)) + return + } + // an enum + // Allocate a []enum, then assign []int32's values into it. + // Note: we can't convert []enum to []int32. + slice := reflect.MakeSlice(p.v.Type().Elem(), len(v), cap(v)) + for i, x := range v { + slice.Index(i).SetInt(int64(x)) + } + p.v.Elem().Set(slice) +} +func (p pointer) appendInt32Slice(v int32) { + grow(p.v.Elem()).SetInt(int64(v)) +} + +func (p pointer) toUint64() *uint64 { + return p.v.Interface().(*uint64) +} +func (p pointer) toUint64Ptr() **uint64 { + return p.v.Interface().(**uint64) +} +func (p pointer) toUint64Slice() *[]uint64 { + return p.v.Interface().(*[]uint64) +} +func (p pointer) toUint32() *uint32 { + return p.v.Interface().(*uint32) +} +func (p pointer) toUint32Ptr() **uint32 { + return p.v.Interface().(**uint32) +} +func (p pointer) toUint32Slice() *[]uint32 { + return p.v.Interface().(*[]uint32) +} +func (p pointer) toBool() *bool { + return p.v.Interface().(*bool) +} +func (p pointer) toBoolPtr() **bool { + return p.v.Interface().(**bool) +} +func (p pointer) toBoolSlice() *[]bool { + return p.v.Interface().(*[]bool) +} +func (p pointer) toFloat64() *float64 { + return p.v.Interface().(*float64) +} +func (p pointer) toFloat64Ptr() **float64 { + return p.v.Interface().(**float64) +} +func (p pointer) toFloat64Slice() *[]float64 { + return p.v.Interface().(*[]float64) +} +func (p pointer) toFloat32() *float32 { + return p.v.Interface().(*float32) +} +func (p pointer) toFloat32Ptr() **float32 { + return p.v.Interface().(**float32) +} +func (p pointer) toFloat32Slice() *[]float32 { + return p.v.Interface().(*[]float32) +} +func (p pointer) toString() *string { + return p.v.Interface().(*string) +} +func (p pointer) toStringPtr() **string { + return p.v.Interface().(**string) +} +func (p pointer) toStringSlice() *[]string { + return p.v.Interface().(*[]string) +} +func (p pointer) toBytes() *[]byte { + return p.v.Interface().(*[]byte) +} +func (p pointer) toBytesSlice() *[][]byte { + return p.v.Interface().(*[][]byte) +} +func (p pointer) toExtensions() *XXX_InternalExtensions { + return p.v.Interface().(*XXX_InternalExtensions) +} +func (p pointer) toOldExtensions() *map[int32]Extension { + return p.v.Interface().(*map[int32]Extension) +} +func (p pointer) getPointer() pointer { + return pointer{v: p.v.Elem()} +} +func (p pointer) setPointer(q pointer) { + p.v.Elem().Set(q.v) +} +func (p pointer) appendPointer(q pointer) { + grow(p.v.Elem()).Set(q.v) +} + +// getPointerSlice copies []*T from p as a new []pointer. +// This behavior differs from the implementation in pointer_unsafe.go. +func (p pointer) getPointerSlice() []pointer { + if p.v.IsNil() { + return nil + } + n := p.v.Elem().Len() + s := make([]pointer, n) + for i := 0; i < n; i++ { + s[i] = pointer{v: p.v.Elem().Index(i)} + } + return s +} + +// setPointerSlice copies []pointer into p as a new []*T. +// This behavior differs from the implementation in pointer_unsafe.go. +func (p pointer) setPointerSlice(v []pointer) { + if v == nil { + p.v.Elem().Set(reflect.New(p.v.Elem().Type()).Elem()) + return + } + s := reflect.MakeSlice(p.v.Elem().Type(), 0, len(v)) + for _, p := range v { + s = reflect.Append(s, p.v) + } + p.v.Elem().Set(s) +} + +// getInterfacePointer returns a pointer that points to the +// interface data of the interface pointed by p. +func (p pointer) getInterfacePointer() pointer { + if p.v.Elem().IsNil() { + return pointer{v: p.v.Elem()} + } + return pointer{v: p.v.Elem().Elem().Elem().Field(0).Addr()} // *interface -> interface -> *struct -> struct +} + +func (p pointer) asPointerTo(t reflect.Type) reflect.Value { + // TODO: check that p.v.Type().Elem() == t? + return p.v +} + +func atomicLoadUnmarshalInfo(p **unmarshalInfo) *unmarshalInfo { + atomicLock.Lock() + defer atomicLock.Unlock() + return *p +} +func atomicStoreUnmarshalInfo(p **unmarshalInfo, v *unmarshalInfo) { + atomicLock.Lock() + defer atomicLock.Unlock() + *p = v +} +func atomicLoadMarshalInfo(p **marshalInfo) *marshalInfo { + atomicLock.Lock() + defer atomicLock.Unlock() + return *p +} +func atomicStoreMarshalInfo(p **marshalInfo, v *marshalInfo) { + atomicLock.Lock() + defer atomicLock.Unlock() + *p = v +} +func atomicLoadMergeInfo(p **mergeInfo) *mergeInfo { + atomicLock.Lock() + defer atomicLock.Unlock() + return *p +} +func atomicStoreMergeInfo(p **mergeInfo, v *mergeInfo) { + atomicLock.Lock() + defer atomicLock.Unlock() + *p = v +} +func atomicLoadDiscardInfo(p **discardInfo) *discardInfo { + atomicLock.Lock() + defer atomicLock.Unlock() + return *p +} +func atomicStoreDiscardInfo(p **discardInfo, v *discardInfo) { + atomicLock.Lock() + defer atomicLock.Unlock() + *p = v +} + +var atomicLock sync.Mutex diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_reflect_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_reflect_gogo.go new file mode 100644 index 000000000000..7ffd3c29d90c --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_reflect_gogo.go @@ -0,0 +1,59 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2018, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// +build purego appengine js + +// This file contains an implementation of proto field accesses using package reflect. +// It is slower than the code in pointer_unsafe.go but it avoids package unsafe and can +// be used on App Engine. + +package proto + +import ( + "reflect" +) + +// TODO: untested, so probably incorrect. + +func (p pointer) getRef() pointer { + return pointer{v: p.v.Addr()} +} + +func (p pointer) appendRef(v pointer, typ reflect.Type) { + slice := p.getSlice(typ) + elem := v.asPointerTo(typ).Elem() + newSlice := reflect.Append(slice, elem) + slice.Set(newSlice) +} + +func (p pointer) getSlice(typ reflect.Type) reflect.Value { + sliceTyp := reflect.SliceOf(typ) + slice := p.asPointerTo(sliceTyp) + slice = slice.Elem() + return slice +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_unsafe.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_unsafe.go new file mode 100644 index 000000000000..d55a335d9453 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_unsafe.go @@ -0,0 +1,308 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2012 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// +build !purego,!appengine,!js + +// This file contains the implementation of the proto field accesses using package unsafe. + +package proto + +import ( + "reflect" + "sync/atomic" + "unsafe" +) + +const unsafeAllowed = true + +// A field identifies a field in a struct, accessible from a pointer. +// In this implementation, a field is identified by its byte offset from the start of the struct. +type field uintptr + +// toField returns a field equivalent to the given reflect field. +func toField(f *reflect.StructField) field { + return field(f.Offset) +} + +// invalidField is an invalid field identifier. +const invalidField = ^field(0) + +// zeroField is a noop when calling pointer.offset. +const zeroField = field(0) + +// IsValid reports whether the field identifier is valid. +func (f field) IsValid() bool { + return f != invalidField +} + +// The pointer type below is for the new table-driven encoder/decoder. +// The implementation here uses unsafe.Pointer to create a generic pointer. +// In pointer_reflect.go we use reflect instead of unsafe to implement +// the same (but slower) interface. +type pointer struct { + p unsafe.Pointer +} + +// size of pointer +var ptrSize = unsafe.Sizeof(uintptr(0)) + +// toPointer converts an interface of pointer type to a pointer +// that points to the same target. +func toPointer(i *Message) pointer { + // Super-tricky - read pointer out of data word of interface value. + // Saves ~25ns over the equivalent: + // return valToPointer(reflect.ValueOf(*i)) + return pointer{p: (*[2]unsafe.Pointer)(unsafe.Pointer(i))[1]} +} + +// toAddrPointer converts an interface to a pointer that points to +// the interface data. +func toAddrPointer(i *interface{}, isptr bool) pointer { + // Super-tricky - read or get the address of data word of interface value. + if isptr { + // The interface is of pointer type, thus it is a direct interface. + // The data word is the pointer data itself. We take its address. + return pointer{p: unsafe.Pointer(uintptr(unsafe.Pointer(i)) + ptrSize)} + } + // The interface is not of pointer type. The data word is the pointer + // to the data. + return pointer{p: (*[2]unsafe.Pointer)(unsafe.Pointer(i))[1]} +} + +// valToPointer converts v to a pointer. v must be of pointer type. +func valToPointer(v reflect.Value) pointer { + return pointer{p: unsafe.Pointer(v.Pointer())} +} + +// offset converts from a pointer to a structure to a pointer to +// one of its fields. +func (p pointer) offset(f field) pointer { + // For safety, we should panic if !f.IsValid, however calling panic causes + // this to no longer be inlineable, which is a serious performance cost. + /* + if !f.IsValid() { + panic("invalid field") + } + */ + return pointer{p: unsafe.Pointer(uintptr(p.p) + uintptr(f))} +} + +func (p pointer) isNil() bool { + return p.p == nil +} + +func (p pointer) toInt64() *int64 { + return (*int64)(p.p) +} +func (p pointer) toInt64Ptr() **int64 { + return (**int64)(p.p) +} +func (p pointer) toInt64Slice() *[]int64 { + return (*[]int64)(p.p) +} +func (p pointer) toInt32() *int32 { + return (*int32)(p.p) +} + +// See pointer_reflect.go for why toInt32Ptr/Slice doesn't exist. +/* + func (p pointer) toInt32Ptr() **int32 { + return (**int32)(p.p) + } + func (p pointer) toInt32Slice() *[]int32 { + return (*[]int32)(p.p) + } +*/ +func (p pointer) getInt32Ptr() *int32 { + return *(**int32)(p.p) +} +func (p pointer) setInt32Ptr(v int32) { + *(**int32)(p.p) = &v +} + +// getInt32Slice loads a []int32 from p. +// The value returned is aliased with the original slice. +// This behavior differs from the implementation in pointer_reflect.go. +func (p pointer) getInt32Slice() []int32 { + return *(*[]int32)(p.p) +} + +// setInt32Slice stores a []int32 to p. +// The value set is aliased with the input slice. +// This behavior differs from the implementation in pointer_reflect.go. +func (p pointer) setInt32Slice(v []int32) { + *(*[]int32)(p.p) = v +} + +// TODO: Can we get rid of appendInt32Slice and use setInt32Slice instead? +func (p pointer) appendInt32Slice(v int32) { + s := (*[]int32)(p.p) + *s = append(*s, v) +} + +func (p pointer) toUint64() *uint64 { + return (*uint64)(p.p) +} +func (p pointer) toUint64Ptr() **uint64 { + return (**uint64)(p.p) +} +func (p pointer) toUint64Slice() *[]uint64 { + return (*[]uint64)(p.p) +} +func (p pointer) toUint32() *uint32 { + return (*uint32)(p.p) +} +func (p pointer) toUint32Ptr() **uint32 { + return (**uint32)(p.p) +} +func (p pointer) toUint32Slice() *[]uint32 { + return (*[]uint32)(p.p) +} +func (p pointer) toBool() *bool { + return (*bool)(p.p) +} +func (p pointer) toBoolPtr() **bool { + return (**bool)(p.p) +} +func (p pointer) toBoolSlice() *[]bool { + return (*[]bool)(p.p) +} +func (p pointer) toFloat64() *float64 { + return (*float64)(p.p) +} +func (p pointer) toFloat64Ptr() **float64 { + return (**float64)(p.p) +} +func (p pointer) toFloat64Slice() *[]float64 { + return (*[]float64)(p.p) +} +func (p pointer) toFloat32() *float32 { + return (*float32)(p.p) +} +func (p pointer) toFloat32Ptr() **float32 { + return (**float32)(p.p) +} +func (p pointer) toFloat32Slice() *[]float32 { + return (*[]float32)(p.p) +} +func (p pointer) toString() *string { + return (*string)(p.p) +} +func (p pointer) toStringPtr() **string { + return (**string)(p.p) +} +func (p pointer) toStringSlice() *[]string { + return (*[]string)(p.p) +} +func (p pointer) toBytes() *[]byte { + return (*[]byte)(p.p) +} +func (p pointer) toBytesSlice() *[][]byte { + return (*[][]byte)(p.p) +} +func (p pointer) toExtensions() *XXX_InternalExtensions { + return (*XXX_InternalExtensions)(p.p) +} +func (p pointer) toOldExtensions() *map[int32]Extension { + return (*map[int32]Extension)(p.p) +} + +// getPointerSlice loads []*T from p as a []pointer. +// The value returned is aliased with the original slice. +// This behavior differs from the implementation in pointer_reflect.go. +func (p pointer) getPointerSlice() []pointer { + // Super-tricky - p should point to a []*T where T is a + // message type. We load it as []pointer. + return *(*[]pointer)(p.p) +} + +// setPointerSlice stores []pointer into p as a []*T. +// The value set is aliased with the input slice. +// This behavior differs from the implementation in pointer_reflect.go. +func (p pointer) setPointerSlice(v []pointer) { + // Super-tricky - p should point to a []*T where T is a + // message type. We store it as []pointer. + *(*[]pointer)(p.p) = v +} + +// getPointer loads the pointer at p and returns it. +func (p pointer) getPointer() pointer { + return pointer{p: *(*unsafe.Pointer)(p.p)} +} + +// setPointer stores the pointer q at p. +func (p pointer) setPointer(q pointer) { + *(*unsafe.Pointer)(p.p) = q.p +} + +// append q to the slice pointed to by p. +func (p pointer) appendPointer(q pointer) { + s := (*[]unsafe.Pointer)(p.p) + *s = append(*s, q.p) +} + +// getInterfacePointer returns a pointer that points to the +// interface data of the interface pointed by p. +func (p pointer) getInterfacePointer() pointer { + // Super-tricky - read pointer out of data word of interface value. + return pointer{p: (*(*[2]unsafe.Pointer)(p.p))[1]} +} + +// asPointerTo returns a reflect.Value that is a pointer to an +// object of type t stored at p. +func (p pointer) asPointerTo(t reflect.Type) reflect.Value { + return reflect.NewAt(t, p.p) +} + +func atomicLoadUnmarshalInfo(p **unmarshalInfo) *unmarshalInfo { + return (*unmarshalInfo)(atomic.LoadPointer((*unsafe.Pointer)(unsafe.Pointer(p)))) +} +func atomicStoreUnmarshalInfo(p **unmarshalInfo, v *unmarshalInfo) { + atomic.StorePointer((*unsafe.Pointer)(unsafe.Pointer(p)), unsafe.Pointer(v)) +} +func atomicLoadMarshalInfo(p **marshalInfo) *marshalInfo { + return (*marshalInfo)(atomic.LoadPointer((*unsafe.Pointer)(unsafe.Pointer(p)))) +} +func atomicStoreMarshalInfo(p **marshalInfo, v *marshalInfo) { + atomic.StorePointer((*unsafe.Pointer)(unsafe.Pointer(p)), unsafe.Pointer(v)) +} +func atomicLoadMergeInfo(p **mergeInfo) *mergeInfo { + return (*mergeInfo)(atomic.LoadPointer((*unsafe.Pointer)(unsafe.Pointer(p)))) +} +func atomicStoreMergeInfo(p **mergeInfo, v *mergeInfo) { + atomic.StorePointer((*unsafe.Pointer)(unsafe.Pointer(p)), unsafe.Pointer(v)) +} +func atomicLoadDiscardInfo(p **discardInfo) *discardInfo { + return (*discardInfo)(atomic.LoadPointer((*unsafe.Pointer)(unsafe.Pointer(p)))) +} +func atomicStoreDiscardInfo(p **discardInfo, v *discardInfo) { + atomic.StorePointer((*unsafe.Pointer)(unsafe.Pointer(p)), unsafe.Pointer(v)) +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_unsafe_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_unsafe_gogo.go new file mode 100644 index 000000000000..b354101b9c3d --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/pointer_unsafe_gogo.go @@ -0,0 +1,56 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2018, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +// +build !purego !appengine,!js + +// This file contains the implementation of the proto field accesses using package unsafe. + +package proto + +import ( + "reflect" + "unsafe" +) + +func (p pointer) getRef() pointer { + return pointer{p: (unsafe.Pointer)(&p.p)} +} + +func (p pointer) appendRef(v pointer, typ reflect.Type) { + slice := p.getSlice(typ) + elem := v.asPointerTo(typ).Elem() + newSlice := reflect.Append(slice, elem) + slice.Set(newSlice) +} + +func (p pointer) getSlice(typ reflect.Type) reflect.Value { + sliceTyp := reflect.SliceOf(typ) + slice := p.asPointerTo(sliceTyp) + slice = slice.Elem() + return slice +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/properties.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/properties.go new file mode 100644 index 000000000000..7a5e28efe519 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/properties.go @@ -0,0 +1,600 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2013, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +/* + * Routines for encoding data into the wire format for protocol buffers. + */ + +import ( + "fmt" + "log" + "os" + "reflect" + "sort" + "strconv" + "strings" + "sync" +) + +const debug bool = false + +// Constants that identify the encoding of a value on the wire. +const ( + WireVarint = 0 + WireFixed64 = 1 + WireBytes = 2 + WireStartGroup = 3 + WireEndGroup = 4 + WireFixed32 = 5 +) + +// tagMap is an optimization over map[int]int for typical protocol buffer +// use-cases. Encoded protocol buffers are often in tag order with small tag +// numbers. +type tagMap struct { + fastTags []int + slowTags map[int]int +} + +// tagMapFastLimit is the upper bound on the tag number that will be stored in +// the tagMap slice rather than its map. +const tagMapFastLimit = 1024 + +func (p *tagMap) get(t int) (int, bool) { + if t > 0 && t < tagMapFastLimit { + if t >= len(p.fastTags) { + return 0, false + } + fi := p.fastTags[t] + return fi, fi >= 0 + } + fi, ok := p.slowTags[t] + return fi, ok +} + +func (p *tagMap) put(t int, fi int) { + if t > 0 && t < tagMapFastLimit { + for len(p.fastTags) < t+1 { + p.fastTags = append(p.fastTags, -1) + } + p.fastTags[t] = fi + return + } + if p.slowTags == nil { + p.slowTags = make(map[int]int) + } + p.slowTags[t] = fi +} + +// StructProperties represents properties for all the fields of a struct. +// decoderTags and decoderOrigNames should only be used by the decoder. +type StructProperties struct { + Prop []*Properties // properties for each field + reqCount int // required count + decoderTags tagMap // map from proto tag to struct field number + decoderOrigNames map[string]int // map from original name to struct field number + order []int // list of struct field numbers in tag order + + // OneofTypes contains information about the oneof fields in this message. + // It is keyed by the original name of a field. + OneofTypes map[string]*OneofProperties +} + +// OneofProperties represents information about a specific field in a oneof. +type OneofProperties struct { + Type reflect.Type // pointer to generated struct type for this oneof field + Field int // struct field number of the containing oneof in the message + Prop *Properties +} + +// Implement the sorting interface so we can sort the fields in tag order, as recommended by the spec. +// See encode.go, (*Buffer).enc_struct. + +func (sp *StructProperties) Len() int { return len(sp.order) } +func (sp *StructProperties) Less(i, j int) bool { + return sp.Prop[sp.order[i]].Tag < sp.Prop[sp.order[j]].Tag +} +func (sp *StructProperties) Swap(i, j int) { sp.order[i], sp.order[j] = sp.order[j], sp.order[i] } + +// Properties represents the protocol-specific behavior of a single struct field. +type Properties struct { + Name string // name of the field, for error messages + OrigName string // original name before protocol compiler (always set) + JSONName string // name to use for JSON; determined by protoc + Wire string + WireType int + Tag int + Required bool + Optional bool + Repeated bool + Packed bool // relevant for repeated primitives only + Enum string // set for enum types only + proto3 bool // whether this is known to be a proto3 field; set for []byte only + oneof bool // whether this is a oneof field + + Default string // default value + HasDefault bool // whether an explicit default was provided + CustomType string + CastType string + StdTime bool + StdDuration bool + + stype reflect.Type // set for struct types only + ctype reflect.Type // set for custom types only + sprop *StructProperties // set for struct types only + + mtype reflect.Type // set for map types only + mkeyprop *Properties // set for map types only + mvalprop *Properties // set for map types only +} + +// String formats the properties in the protobuf struct field tag style. +func (p *Properties) String() string { + s := p.Wire + s += "," + s += strconv.Itoa(p.Tag) + if p.Required { + s += ",req" + } + if p.Optional { + s += ",opt" + } + if p.Repeated { + s += ",rep" + } + if p.Packed { + s += ",packed" + } + s += ",name=" + p.OrigName + if p.JSONName != p.OrigName { + s += ",json=" + p.JSONName + } + if p.proto3 { + s += ",proto3" + } + if p.oneof { + s += ",oneof" + } + if len(p.Enum) > 0 { + s += ",enum=" + p.Enum + } + if p.HasDefault { + s += ",def=" + p.Default + } + return s +} + +// Parse populates p by parsing a string in the protobuf struct field tag style. +func (p *Properties) Parse(s string) { + // "bytes,49,opt,name=foo,def=hello!" + fields := strings.Split(s, ",") // breaks def=, but handled below. + if len(fields) < 2 { + fmt.Fprintf(os.Stderr, "proto: tag has too few fields: %q\n", s) + return + } + + p.Wire = fields[0] + switch p.Wire { + case "varint": + p.WireType = WireVarint + case "fixed32": + p.WireType = WireFixed32 + case "fixed64": + p.WireType = WireFixed64 + case "zigzag32": + p.WireType = WireVarint + case "zigzag64": + p.WireType = WireVarint + case "bytes", "group": + p.WireType = WireBytes + // no numeric converter for non-numeric types + default: + fmt.Fprintf(os.Stderr, "proto: tag has unknown wire type: %q\n", s) + return + } + + var err error + p.Tag, err = strconv.Atoi(fields[1]) + if err != nil { + return + } + +outer: + for i := 2; i < len(fields); i++ { + f := fields[i] + switch { + case f == "req": + p.Required = true + case f == "opt": + p.Optional = true + case f == "rep": + p.Repeated = true + case f == "packed": + p.Packed = true + case strings.HasPrefix(f, "name="): + p.OrigName = f[5:] + case strings.HasPrefix(f, "json="): + p.JSONName = f[5:] + case strings.HasPrefix(f, "enum="): + p.Enum = f[5:] + case f == "proto3": + p.proto3 = true + case f == "oneof": + p.oneof = true + case strings.HasPrefix(f, "def="): + p.HasDefault = true + p.Default = f[4:] // rest of string + if i+1 < len(fields) { + // Commas aren't escaped, and def is always last. + p.Default += "," + strings.Join(fields[i+1:], ",") + break outer + } + case strings.HasPrefix(f, "embedded="): + p.OrigName = strings.Split(f, "=")[1] + case strings.HasPrefix(f, "customtype="): + p.CustomType = strings.Split(f, "=")[1] + case strings.HasPrefix(f, "casttype="): + p.CastType = strings.Split(f, "=")[1] + case f == "stdtime": + p.StdTime = true + case f == "stdduration": + p.StdDuration = true + } + } +} + +var protoMessageType = reflect.TypeOf((*Message)(nil)).Elem() + +// setFieldProps initializes the field properties for submessages and maps. +func (p *Properties) setFieldProps(typ reflect.Type, f *reflect.StructField, lockGetProp bool) { + isMap := typ.Kind() == reflect.Map + if len(p.CustomType) > 0 && !isMap { + p.ctype = typ + p.setTag(lockGetProp) + return + } + if p.StdTime && !isMap { + p.setTag(lockGetProp) + return + } + if p.StdDuration && !isMap { + p.setTag(lockGetProp) + return + } + switch t1 := typ; t1.Kind() { + case reflect.Struct: + p.stype = typ + case reflect.Ptr: + if t1.Elem().Kind() == reflect.Struct { + p.stype = t1.Elem() + } + case reflect.Slice: + switch t2 := t1.Elem(); t2.Kind() { + case reflect.Ptr: + switch t3 := t2.Elem(); t3.Kind() { + case reflect.Struct: + p.stype = t3 + } + case reflect.Struct: + p.stype = t2 + } + + case reflect.Map: + + p.mtype = t1 + p.mkeyprop = &Properties{} + p.mkeyprop.init(reflect.PtrTo(p.mtype.Key()), "Key", f.Tag.Get("protobuf_key"), nil, lockGetProp) + p.mvalprop = &Properties{} + vtype := p.mtype.Elem() + if vtype.Kind() != reflect.Ptr && vtype.Kind() != reflect.Slice { + // The value type is not a message (*T) or bytes ([]byte), + // so we need encoders for the pointer to this type. + vtype = reflect.PtrTo(vtype) + } + + p.mvalprop.CustomType = p.CustomType + p.mvalprop.StdDuration = p.StdDuration + p.mvalprop.StdTime = p.StdTime + p.mvalprop.init(vtype, "Value", f.Tag.Get("protobuf_val"), nil, lockGetProp) + } + p.setTag(lockGetProp) +} + +func (p *Properties) setTag(lockGetProp bool) { + if p.stype != nil { + if lockGetProp { + p.sprop = GetProperties(p.stype) + } else { + p.sprop = getPropertiesLocked(p.stype) + } + } +} + +var ( + marshalerType = reflect.TypeOf((*Marshaler)(nil)).Elem() +) + +// Init populates the properties from a protocol buffer struct tag. +func (p *Properties) Init(typ reflect.Type, name, tag string, f *reflect.StructField) { + p.init(typ, name, tag, f, true) +} + +func (p *Properties) init(typ reflect.Type, name, tag string, f *reflect.StructField, lockGetProp bool) { + // "bytes,49,opt,def=hello!" + p.Name = name + p.OrigName = name + if tag == "" { + return + } + p.Parse(tag) + p.setFieldProps(typ, f, lockGetProp) +} + +var ( + propertiesMu sync.RWMutex + propertiesMap = make(map[reflect.Type]*StructProperties) +) + +// GetProperties returns the list of properties for the type represented by t. +// t must represent a generated struct type of a protocol message. +func GetProperties(t reflect.Type) *StructProperties { + if t.Kind() != reflect.Struct { + panic("proto: type must have kind struct") + } + + // Most calls to GetProperties in a long-running program will be + // retrieving details for types we have seen before. + propertiesMu.RLock() + sprop, ok := propertiesMap[t] + propertiesMu.RUnlock() + if ok { + if collectStats { + stats.Chit++ + } + return sprop + } + + propertiesMu.Lock() + sprop = getPropertiesLocked(t) + propertiesMu.Unlock() + return sprop +} + +// getPropertiesLocked requires that propertiesMu is held. +func getPropertiesLocked(t reflect.Type) *StructProperties { + if prop, ok := propertiesMap[t]; ok { + if collectStats { + stats.Chit++ + } + return prop + } + if collectStats { + stats.Cmiss++ + } + + prop := new(StructProperties) + // in case of recursive protos, fill this in now. + propertiesMap[t] = prop + + // build properties + prop.Prop = make([]*Properties, t.NumField()) + prop.order = make([]int, t.NumField()) + + isOneofMessage := false + for i := 0; i < t.NumField(); i++ { + f := t.Field(i) + p := new(Properties) + name := f.Name + p.init(f.Type, name, f.Tag.Get("protobuf"), &f, false) + + oneof := f.Tag.Get("protobuf_oneof") // special case + if oneof != "" { + isOneofMessage = true + // Oneof fields don't use the traditional protobuf tag. + p.OrigName = oneof + } + prop.Prop[i] = p + prop.order[i] = i + if debug { + print(i, " ", f.Name, " ", t.String(), " ") + if p.Tag > 0 { + print(p.String()) + } + print("\n") + } + } + + // Re-order prop.order. + sort.Sort(prop) + + type oneofMessage interface { + XXX_OneofFuncs() (func(Message, *Buffer) error, func(Message, int, int, *Buffer) (bool, error), func(Message) int, []interface{}) + } + if om, ok := reflect.Zero(reflect.PtrTo(t)).Interface().(oneofMessage); isOneofMessage && ok { + var oots []interface{} + _, _, _, oots = om.XXX_OneofFuncs() + + // Interpret oneof metadata. + prop.OneofTypes = make(map[string]*OneofProperties) + for _, oot := range oots { + oop := &OneofProperties{ + Type: reflect.ValueOf(oot).Type(), // *T + Prop: new(Properties), + } + sft := oop.Type.Elem().Field(0) + oop.Prop.Name = sft.Name + oop.Prop.Parse(sft.Tag.Get("protobuf")) + // There will be exactly one interface field that + // this new value is assignable to. + for i := 0; i < t.NumField(); i++ { + f := t.Field(i) + if f.Type.Kind() != reflect.Interface { + continue + } + if !oop.Type.AssignableTo(f.Type) { + continue + } + oop.Field = i + break + } + prop.OneofTypes[oop.Prop.OrigName] = oop + } + } + + // build required counts + // build tags + reqCount := 0 + prop.decoderOrigNames = make(map[string]int) + for i, p := range prop.Prop { + if strings.HasPrefix(p.Name, "XXX_") { + // Internal fields should not appear in tags/origNames maps. + // They are handled specially when encoding and decoding. + continue + } + if p.Required { + reqCount++ + } + prop.decoderTags.put(p.Tag, i) + prop.decoderOrigNames[p.OrigName] = i + } + prop.reqCount = reqCount + + return prop +} + +// A global registry of enum types. +// The generated code will register the generated maps by calling RegisterEnum. + +var enumValueMaps = make(map[string]map[string]int32) +var enumStringMaps = make(map[string]map[int32]string) + +// RegisterEnum is called from the generated code to install the enum descriptor +// maps into the global table to aid parsing text format protocol buffers. +func RegisterEnum(typeName string, unusedNameMap map[int32]string, valueMap map[string]int32) { + if _, ok := enumValueMaps[typeName]; ok { + panic("proto: duplicate enum registered: " + typeName) + } + enumValueMaps[typeName] = valueMap + if _, ok := enumStringMaps[typeName]; ok { + panic("proto: duplicate enum registered: " + typeName) + } + enumStringMaps[typeName] = unusedNameMap +} + +// EnumValueMap returns the mapping from names to integers of the +// enum type enumType, or a nil if not found. +func EnumValueMap(enumType string) map[string]int32 { + return enumValueMaps[enumType] +} + +// A registry of all linked message types. +// The string is a fully-qualified proto name ("pkg.Message"). +var ( + protoTypedNils = make(map[string]Message) // a map from proto names to typed nil pointers + protoMapTypes = make(map[string]reflect.Type) // a map from proto names to map types + revProtoTypes = make(map[reflect.Type]string) +) + +// RegisterType is called from generated code and maps from the fully qualified +// proto name to the type (pointer to struct) of the protocol buffer. +func RegisterType(x Message, name string) { + if _, ok := protoTypedNils[name]; ok { + // TODO: Some day, make this a panic. + log.Printf("proto: duplicate proto type registered: %s", name) + return + } + t := reflect.TypeOf(x) + if v := reflect.ValueOf(x); v.Kind() == reflect.Ptr && v.Pointer() == 0 { + // Generated code always calls RegisterType with nil x. + // This check is just for extra safety. + protoTypedNils[name] = x + } else { + protoTypedNils[name] = reflect.Zero(t).Interface().(Message) + } + revProtoTypes[t] = name +} + +// RegisterMapType is called from generated code and maps from the fully qualified +// proto name to the native map type of the proto map definition. +func RegisterMapType(x interface{}, name string) { + if reflect.TypeOf(x).Kind() != reflect.Map { + panic(fmt.Sprintf("RegisterMapType(%T, %q); want map", x, name)) + } + if _, ok := protoMapTypes[name]; ok { + log.Printf("proto: duplicate proto type registered: %s", name) + return + } + t := reflect.TypeOf(x) + protoMapTypes[name] = t + revProtoTypes[t] = name +} + +// MessageName returns the fully-qualified proto name for the given message type. +func MessageName(x Message) string { + type xname interface { + XXX_MessageName() string + } + if m, ok := x.(xname); ok { + return m.XXX_MessageName() + } + return revProtoTypes[reflect.TypeOf(x)] +} + +// MessageType returns the message type (pointer to struct) for a named message. +// The type is not guaranteed to implement proto.Message if the name refers to a +// map entry. +func MessageType(name string) reflect.Type { + if t, ok := protoTypedNils[name]; ok { + return reflect.TypeOf(t) + } + return protoMapTypes[name] +} + +// A registry of all linked proto files. +var ( + protoFiles = make(map[string][]byte) // file name => fileDescriptor +) + +// RegisterFile is called from generated code and maps from the +// full file name of a .proto file to its compressed FileDescriptorProto. +func RegisterFile(filename string, fileDescriptor []byte) { + protoFiles[filename] = fileDescriptor +} + +// FileDescriptor returns the compressed FileDescriptorProto for a .proto file. +func FileDescriptor(filename string) []byte { return protoFiles[filename] } diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/properties_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/properties_gogo.go new file mode 100644 index 000000000000..40ea3dd935c2 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/properties_gogo.go @@ -0,0 +1,36 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2018, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "reflect" +) + +var sizerType = reflect.TypeOf((*Sizer)(nil)).Elem() +var protosizerType = reflect.TypeOf((*ProtoSizer)(nil)).Elem() diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/skip_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/skip_gogo.go new file mode 100644 index 000000000000..5a5fd93f7c19 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/skip_gogo.go @@ -0,0 +1,119 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2013, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "fmt" + "io" +) + +func Skip(data []byte) (n int, err error) { + l := len(data) + index := 0 + for index < l { + var wire uint64 + for shift := uint(0); ; shift += 7 { + if index >= l { + return 0, io.ErrUnexpectedEOF + } + b := data[index] + index++ + wire |= (uint64(b) & 0x7F) << shift + if b < 0x80 { + break + } + } + wireType := int(wire & 0x7) + switch wireType { + case 0: + for { + if index >= l { + return 0, io.ErrUnexpectedEOF + } + index++ + if data[index-1] < 0x80 { + break + } + } + return index, nil + case 1: + index += 8 + return index, nil + case 2: + var length int + for shift := uint(0); ; shift += 7 { + if index >= l { + return 0, io.ErrUnexpectedEOF + } + b := data[index] + index++ + length |= (int(b) & 0x7F) << shift + if b < 0x80 { + break + } + } + index += length + return index, nil + case 3: + for { + var innerWire uint64 + var start int = index + for shift := uint(0); ; shift += 7 { + if index >= l { + return 0, io.ErrUnexpectedEOF + } + b := data[index] + index++ + innerWire |= (uint64(b) & 0x7F) << shift + if b < 0x80 { + break + } + } + innerWireType := int(innerWire & 0x7) + if innerWireType == 4 { + break + } + next, err := Skip(data[start:]) + if err != nil { + return 0, err + } + index = start + next + } + return index, nil + case 4: + return index, nil + case 5: + index += 4 + return index, nil + default: + return 0, fmt.Errorf("proto: illegal wireType %d", wireType) + } + } + panic("unreachable") +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/table_marshal.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/table_marshal.go new file mode 100644 index 000000000000..255e7b508860 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/table_marshal.go @@ -0,0 +1,2799 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2016 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "errors" + "fmt" + "math" + "reflect" + "sort" + "strconv" + "strings" + "sync" + "sync/atomic" + "unicode/utf8" +) + +// a sizer takes a pointer to a field and the size of its tag, computes the size of +// the encoded data. +type sizer func(pointer, int) int + +// a marshaler takes a byte slice, a pointer to a field, and its tag (in wire format), +// marshals the field to the end of the slice, returns the slice and error (if any). +type marshaler func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) + +// marshalInfo is the information used for marshaling a message. +type marshalInfo struct { + typ reflect.Type + fields []*marshalFieldInfo + unrecognized field // offset of XXX_unrecognized + extensions field // offset of XXX_InternalExtensions + v1extensions field // offset of XXX_extensions + sizecache field // offset of XXX_sizecache + initialized int32 // 0 -- only typ is set, 1 -- fully initialized + messageset bool // uses message set wire format + hasmarshaler bool // has custom marshaler + sync.RWMutex // protect extElems map, also for initialization + extElems map[int32]*marshalElemInfo // info of extension elements + + hassizer bool // has custom sizer + hasprotosizer bool // has custom protosizer + + bytesExtensions field // offset of XXX_extensions where the field type is []byte +} + +// marshalFieldInfo is the information used for marshaling a field of a message. +type marshalFieldInfo struct { + field field + wiretag uint64 // tag in wire format + tagsize int // size of tag in wire format + sizer sizer + marshaler marshaler + isPointer bool + required bool // field is required + name string // name of the field, for error reporting + oneofElems map[reflect.Type]*marshalElemInfo // info of oneof elements +} + +// marshalElemInfo is the information used for marshaling an extension or oneof element. +type marshalElemInfo struct { + wiretag uint64 // tag in wire format + tagsize int // size of tag in wire format + sizer sizer + marshaler marshaler + isptr bool // elem is pointer typed, thus interface of this type is a direct interface (extension only) +} + +var ( + marshalInfoMap = map[reflect.Type]*marshalInfo{} + marshalInfoLock sync.Mutex +) + +// getMarshalInfo returns the information to marshal a given type of message. +// The info it returns may not necessarily initialized. +// t is the type of the message (NOT the pointer to it). +func getMarshalInfo(t reflect.Type) *marshalInfo { + marshalInfoLock.Lock() + u, ok := marshalInfoMap[t] + if !ok { + u = &marshalInfo{typ: t} + marshalInfoMap[t] = u + } + marshalInfoLock.Unlock() + return u +} + +// Size is the entry point from generated code, +// and should be ONLY called by generated code. +// It computes the size of encoded data of msg. +// a is a pointer to a place to store cached marshal info. +func (a *InternalMessageInfo) Size(msg Message) int { + u := getMessageMarshalInfo(msg, a) + ptr := toPointer(&msg) + if ptr.isNil() { + // We get here if msg is a typed nil ((*SomeMessage)(nil)), + // so it satisfies the interface, and msg == nil wouldn't + // catch it. We don't want crash in this case. + return 0 + } + return u.size(ptr) +} + +// Marshal is the entry point from generated code, +// and should be ONLY called by generated code. +// It marshals msg to the end of b. +// a is a pointer to a place to store cached marshal info. +func (a *InternalMessageInfo) Marshal(b []byte, msg Message, deterministic bool) ([]byte, error) { + u := getMessageMarshalInfo(msg, a) + ptr := toPointer(&msg) + if ptr.isNil() { + // We get here if msg is a typed nil ((*SomeMessage)(nil)), + // so it satisfies the interface, and msg == nil wouldn't + // catch it. We don't want crash in this case. + return b, ErrNil + } + return u.marshal(b, ptr, deterministic) +} + +func getMessageMarshalInfo(msg interface{}, a *InternalMessageInfo) *marshalInfo { + // u := a.marshal, but atomically. + // We use an atomic here to ensure memory consistency. + u := atomicLoadMarshalInfo(&a.marshal) + if u == nil { + // Get marshal information from type of message. + t := reflect.ValueOf(msg).Type() + if t.Kind() != reflect.Ptr { + panic(fmt.Sprintf("cannot handle non-pointer message type %v", t)) + } + u = getMarshalInfo(t.Elem()) + // Store it in the cache for later users. + // a.marshal = u, but atomically. + atomicStoreMarshalInfo(&a.marshal, u) + } + return u +} + +// size is the main function to compute the size of the encoded data of a message. +// ptr is the pointer to the message. +func (u *marshalInfo) size(ptr pointer) int { + if atomic.LoadInt32(&u.initialized) == 0 { + u.computeMarshalInfo() + } + + // If the message can marshal itself, let it do it, for compatibility. + // NOTE: This is not efficient. + if u.hasmarshaler { + // Uses the message's Size method if available + if u.hassizer { + s := ptr.asPointerTo(u.typ).Interface().(Sizer) + return s.Size() + } + // Uses the message's ProtoSize method if available + if u.hasprotosizer { + s := ptr.asPointerTo(u.typ).Interface().(ProtoSizer) + return s.ProtoSize() + } + + m := ptr.asPointerTo(u.typ).Interface().(Marshaler) + b, _ := m.Marshal() + return len(b) + } + + n := 0 + for _, f := range u.fields { + if f.isPointer && ptr.offset(f.field).getPointer().isNil() { + // nil pointer always marshals to nothing + continue + } + n += f.sizer(ptr.offset(f.field), f.tagsize) + } + if u.extensions.IsValid() { + e := ptr.offset(u.extensions).toExtensions() + if u.messageset { + n += u.sizeMessageSet(e) + } else { + n += u.sizeExtensions(e) + } + } + if u.v1extensions.IsValid() { + m := *ptr.offset(u.v1extensions).toOldExtensions() + n += u.sizeV1Extensions(m) + } + if u.bytesExtensions.IsValid() { + s := *ptr.offset(u.bytesExtensions).toBytes() + n += len(s) + } + if u.unrecognized.IsValid() { + s := *ptr.offset(u.unrecognized).toBytes() + n += len(s) + } + + // cache the result for use in marshal + if u.sizecache.IsValid() { + atomic.StoreInt32(ptr.offset(u.sizecache).toInt32(), int32(n)) + } + return n +} + +// cachedsize gets the size from cache. If there is no cache (i.e. message is not generated), +// fall back to compute the size. +func (u *marshalInfo) cachedsize(ptr pointer) int { + if u.sizecache.IsValid() { + return int(atomic.LoadInt32(ptr.offset(u.sizecache).toInt32())) + } + return u.size(ptr) +} + +// marshal is the main function to marshal a message. It takes a byte slice and appends +// the encoded data to the end of the slice, returns the slice and error (if any). +// ptr is the pointer to the message. +// If deterministic is true, map is marshaled in deterministic order. +func (u *marshalInfo) marshal(b []byte, ptr pointer, deterministic bool) ([]byte, error) { + if atomic.LoadInt32(&u.initialized) == 0 { + u.computeMarshalInfo() + } + + // If the message can marshal itself, let it do it, for compatibility. + // NOTE: This is not efficient. + if u.hasmarshaler { + if deterministic { + return nil, errors.New("proto: deterministic not supported by the Marshal method of " + u.typ.String()) + } + m := ptr.asPointerTo(u.typ).Interface().(Marshaler) + b1, err := m.Marshal() + b = append(b, b1...) + return b, err + } + + var err, errreq error + // The old marshaler encodes extensions at beginning. + if u.extensions.IsValid() { + e := ptr.offset(u.extensions).toExtensions() + if u.messageset { + b, err = u.appendMessageSet(b, e, deterministic) + } else { + b, err = u.appendExtensions(b, e, deterministic) + } + if err != nil { + return b, err + } + } + if u.v1extensions.IsValid() { + m := *ptr.offset(u.v1extensions).toOldExtensions() + b, err = u.appendV1Extensions(b, m, deterministic) + if err != nil { + return b, err + } + } + if u.bytesExtensions.IsValid() { + s := *ptr.offset(u.bytesExtensions).toBytes() + b = append(b, s...) + } + for _, f := range u.fields { + if f.required && errreq == nil { + if ptr.offset(f.field).getPointer().isNil() { + // Required field is not set. + // We record the error but keep going, to give a complete marshaling. + errreq = &RequiredNotSetError{f.name} + continue + } + } + if f.isPointer && ptr.offset(f.field).getPointer().isNil() { + // nil pointer always marshals to nothing + continue + } + b, err = f.marshaler(b, ptr.offset(f.field), f.wiretag, deterministic) + if err != nil { + if err1, ok := err.(*RequiredNotSetError); ok { + // Required field in submessage is not set. + // We record the error but keep going, to give a complete marshaling. + if errreq == nil { + errreq = &RequiredNotSetError{f.name + "." + err1.field} + } + continue + } + if err == errRepeatedHasNil { + err = errors.New("proto: repeated field " + f.name + " has nil element") + } + return b, err + } + } + if u.unrecognized.IsValid() { + s := *ptr.offset(u.unrecognized).toBytes() + b = append(b, s...) + } + return b, errreq +} + +// computeMarshalInfo initializes the marshal info. +func (u *marshalInfo) computeMarshalInfo() { + u.Lock() + defer u.Unlock() + if u.initialized != 0 { // non-atomic read is ok as it is protected by the lock + return + } + + t := u.typ + u.unrecognized = invalidField + u.extensions = invalidField + u.v1extensions = invalidField + u.bytesExtensions = invalidField + u.sizecache = invalidField + isOneofMessage := false + + if reflect.PtrTo(t).Implements(sizerType) { + u.hassizer = true + } + if reflect.PtrTo(t).Implements(protosizerType) { + u.hasprotosizer = true + } + // If the message can marshal itself, let it do it, for compatibility. + // NOTE: This is not efficient. + if reflect.PtrTo(t).Implements(marshalerType) { + u.hasmarshaler = true + atomic.StoreInt32(&u.initialized, 1) + return + } + + n := t.NumField() + + // deal with XXX fields first + for i := 0; i < t.NumField(); i++ { + f := t.Field(i) + if f.Tag.Get("protobuf_oneof") != "" { + isOneofMessage = true + } + if !strings.HasPrefix(f.Name, "XXX_") { + continue + } + switch f.Name { + case "XXX_sizecache": + u.sizecache = toField(&f) + case "XXX_unrecognized": + u.unrecognized = toField(&f) + case "XXX_InternalExtensions": + u.extensions = toField(&f) + u.messageset = f.Tag.Get("protobuf_messageset") == "1" + case "XXX_extensions": + if f.Type.Kind() == reflect.Map { + u.v1extensions = toField(&f) + } else { + u.bytesExtensions = toField(&f) + } + case "XXX_NoUnkeyedLiteral": + // nothing to do + default: + panic("unknown XXX field: " + f.Name) + } + n-- + } + + // get oneof implementers + var oneofImplementers []interface{} + // gogo: isOneofMessage is needed for embedded oneof messages, without a marshaler and unmarshaler + if m, ok := reflect.Zero(reflect.PtrTo(t)).Interface().(oneofMessage); ok && isOneofMessage { + _, _, _, oneofImplementers = m.XXX_OneofFuncs() + } + + // normal fields + fields := make([]marshalFieldInfo, n) // batch allocation + u.fields = make([]*marshalFieldInfo, 0, n) + for i, j := 0, 0; i < t.NumField(); i++ { + f := t.Field(i) + + if strings.HasPrefix(f.Name, "XXX_") { + continue + } + field := &fields[j] + j++ + field.name = f.Name + u.fields = append(u.fields, field) + if f.Tag.Get("protobuf_oneof") != "" { + field.computeOneofFieldInfo(&f, oneofImplementers) + continue + } + if f.Tag.Get("protobuf") == "" { + // field has no tag (not in generated message), ignore it + u.fields = u.fields[:len(u.fields)-1] + j-- + continue + } + field.computeMarshalFieldInfo(&f) + } + + // fields are marshaled in tag order on the wire. + sort.Sort(byTag(u.fields)) + + atomic.StoreInt32(&u.initialized, 1) +} + +// helper for sorting fields by tag +type byTag []*marshalFieldInfo + +func (a byTag) Len() int { return len(a) } +func (a byTag) Swap(i, j int) { a[i], a[j] = a[j], a[i] } +func (a byTag) Less(i, j int) bool { return a[i].wiretag < a[j].wiretag } + +// getExtElemInfo returns the information to marshal an extension element. +// The info it returns is initialized. +func (u *marshalInfo) getExtElemInfo(desc *ExtensionDesc) *marshalElemInfo { + // get from cache first + u.RLock() + e, ok := u.extElems[desc.Field] + u.RUnlock() + if ok { + return e + } + + t := reflect.TypeOf(desc.ExtensionType) // pointer or slice to basic type or struct + tags := strings.Split(desc.Tag, ",") + tag, err := strconv.Atoi(tags[1]) + if err != nil { + panic("tag is not an integer") + } + wt := wiretype(tags[0]) + sizr, marshalr := typeMarshaler(t, tags, false, false) + e = &marshalElemInfo{ + wiretag: uint64(tag)<<3 | wt, + tagsize: SizeVarint(uint64(tag) << 3), + sizer: sizr, + marshaler: marshalr, + isptr: t.Kind() == reflect.Ptr, + } + + // update cache + u.Lock() + if u.extElems == nil { + u.extElems = make(map[int32]*marshalElemInfo) + } + u.extElems[desc.Field] = e + u.Unlock() + return e +} + +// computeMarshalFieldInfo fills up the information to marshal a field. +func (fi *marshalFieldInfo) computeMarshalFieldInfo(f *reflect.StructField) { + // parse protobuf tag of the field. + // tag has format of "bytes,49,opt,name=foo,def=hello!" + tags := strings.Split(f.Tag.Get("protobuf"), ",") + if tags[0] == "" { + return + } + tag, err := strconv.Atoi(tags[1]) + if err != nil { + panic("tag is not an integer") + } + wt := wiretype(tags[0]) + if tags[2] == "req" { + fi.required = true + } + fi.setTag(f, tag, wt) + fi.setMarshaler(f, tags) +} + +func (fi *marshalFieldInfo) computeOneofFieldInfo(f *reflect.StructField, oneofImplementers []interface{}) { + fi.field = toField(f) + fi.wiretag = 1<<31 - 1 // Use a large tag number, make oneofs sorted at the end. This tag will not appear on the wire. + fi.isPointer = true + fi.sizer, fi.marshaler = makeOneOfMarshaler(fi, f) + fi.oneofElems = make(map[reflect.Type]*marshalElemInfo) + + ityp := f.Type // interface type + for _, o := range oneofImplementers { + t := reflect.TypeOf(o) + if !t.Implements(ityp) { + continue + } + sf := t.Elem().Field(0) // oneof implementer is a struct with a single field + tags := strings.Split(sf.Tag.Get("protobuf"), ",") + tag, err := strconv.Atoi(tags[1]) + if err != nil { + panic("tag is not an integer") + } + wt := wiretype(tags[0]) + sizr, marshalr := typeMarshaler(sf.Type, tags, false, true) // oneof should not omit any zero value + fi.oneofElems[t.Elem()] = &marshalElemInfo{ + wiretag: uint64(tag)<<3 | wt, + tagsize: SizeVarint(uint64(tag) << 3), + sizer: sizr, + marshaler: marshalr, + } + } +} + +type oneofMessage interface { + XXX_OneofFuncs() (func(Message, *Buffer) error, func(Message, int, int, *Buffer) (bool, error), func(Message) int, []interface{}) +} + +// wiretype returns the wire encoding of the type. +func wiretype(encoding string) uint64 { + switch encoding { + case "fixed32": + return WireFixed32 + case "fixed64": + return WireFixed64 + case "varint", "zigzag32", "zigzag64": + return WireVarint + case "bytes": + return WireBytes + case "group": + return WireStartGroup + } + panic("unknown wire type " + encoding) +} + +// setTag fills up the tag (in wire format) and its size in the info of a field. +func (fi *marshalFieldInfo) setTag(f *reflect.StructField, tag int, wt uint64) { + fi.field = toField(f) + fi.wiretag = uint64(tag)<<3 | wt + fi.tagsize = SizeVarint(uint64(tag) << 3) +} + +// setMarshaler fills up the sizer and marshaler in the info of a field. +func (fi *marshalFieldInfo) setMarshaler(f *reflect.StructField, tags []string) { + switch f.Type.Kind() { + case reflect.Map: + // map field + fi.isPointer = true + fi.sizer, fi.marshaler = makeMapMarshaler(f) + return + case reflect.Ptr, reflect.Slice: + fi.isPointer = true + } + fi.sizer, fi.marshaler = typeMarshaler(f.Type, tags, true, false) +} + +// typeMarshaler returns the sizer and marshaler of a given field. +// t is the type of the field. +// tags is the generated "protobuf" tag of the field. +// If nozero is true, zero value is not marshaled to the wire. +// If oneof is true, it is a oneof field. +func typeMarshaler(t reflect.Type, tags []string, nozero, oneof bool) (sizer, marshaler) { + encoding := tags[0] + + pointer := false + slice := false + if t.Kind() == reflect.Slice && t.Elem().Kind() != reflect.Uint8 { + slice = true + t = t.Elem() + } + if t.Kind() == reflect.Ptr { + pointer = true + t = t.Elem() + } + + packed := false + proto3 := false + ctype := false + isTime := false + isDuration := false + for i := 2; i < len(tags); i++ { + if tags[i] == "packed" { + packed = true + } + if tags[i] == "proto3" { + proto3 = true + } + if strings.HasPrefix(tags[i], "customtype=") { + ctype = true + } + if tags[i] == "stdtime" { + isTime = true + } + if tags[i] == "stdduration" { + isDuration = true + } + } + if !proto3 && !pointer && !slice { + nozero = false + } + + if ctype { + if reflect.PtrTo(t).Implements(customType) { + if slice { + return makeMessageRefSliceMarshaler(getMarshalInfo(t)) + } + if pointer { + return makeCustomPtrMarshaler(getMarshalInfo(t)) + } + return makeCustomMarshaler(getMarshalInfo(t)) + } else { + panic(fmt.Sprintf("custom type: type: %v, does not implement the proto.custom interface", t)) + } + } + + if isTime { + if pointer { + if slice { + return makeTimePtrSliceMarshaler(getMarshalInfo(t)) + } + return makeTimePtrMarshaler(getMarshalInfo(t)) + } + if slice { + return makeTimeSliceMarshaler(getMarshalInfo(t)) + } + return makeTimeMarshaler(getMarshalInfo(t)) + } + + if isDuration { + if pointer { + if slice { + return makeDurationPtrSliceMarshaler(getMarshalInfo(t)) + } + return makeDurationPtrMarshaler(getMarshalInfo(t)) + } + if slice { + return makeDurationSliceMarshaler(getMarshalInfo(t)) + } + return makeDurationMarshaler(getMarshalInfo(t)) + } + + switch t.Kind() { + case reflect.Bool: + if pointer { + return sizeBoolPtr, appendBoolPtr + } + if slice { + if packed { + return sizeBoolPackedSlice, appendBoolPackedSlice + } + return sizeBoolSlice, appendBoolSlice + } + if nozero { + return sizeBoolValueNoZero, appendBoolValueNoZero + } + return sizeBoolValue, appendBoolValue + case reflect.Uint32: + switch encoding { + case "fixed32": + if pointer { + return sizeFixed32Ptr, appendFixed32Ptr + } + if slice { + if packed { + return sizeFixed32PackedSlice, appendFixed32PackedSlice + } + return sizeFixed32Slice, appendFixed32Slice + } + if nozero { + return sizeFixed32ValueNoZero, appendFixed32ValueNoZero + } + return sizeFixed32Value, appendFixed32Value + case "varint": + if pointer { + return sizeVarint32Ptr, appendVarint32Ptr + } + if slice { + if packed { + return sizeVarint32PackedSlice, appendVarint32PackedSlice + } + return sizeVarint32Slice, appendVarint32Slice + } + if nozero { + return sizeVarint32ValueNoZero, appendVarint32ValueNoZero + } + return sizeVarint32Value, appendVarint32Value + } + case reflect.Int32: + switch encoding { + case "fixed32": + if pointer { + return sizeFixedS32Ptr, appendFixedS32Ptr + } + if slice { + if packed { + return sizeFixedS32PackedSlice, appendFixedS32PackedSlice + } + return sizeFixedS32Slice, appendFixedS32Slice + } + if nozero { + return sizeFixedS32ValueNoZero, appendFixedS32ValueNoZero + } + return sizeFixedS32Value, appendFixedS32Value + case "varint": + if pointer { + return sizeVarintS32Ptr, appendVarintS32Ptr + } + if slice { + if packed { + return sizeVarintS32PackedSlice, appendVarintS32PackedSlice + } + return sizeVarintS32Slice, appendVarintS32Slice + } + if nozero { + return sizeVarintS32ValueNoZero, appendVarintS32ValueNoZero + } + return sizeVarintS32Value, appendVarintS32Value + case "zigzag32": + if pointer { + return sizeZigzag32Ptr, appendZigzag32Ptr + } + if slice { + if packed { + return sizeZigzag32PackedSlice, appendZigzag32PackedSlice + } + return sizeZigzag32Slice, appendZigzag32Slice + } + if nozero { + return sizeZigzag32ValueNoZero, appendZigzag32ValueNoZero + } + return sizeZigzag32Value, appendZigzag32Value + } + case reflect.Uint64: + switch encoding { + case "fixed64": + if pointer { + return sizeFixed64Ptr, appendFixed64Ptr + } + if slice { + if packed { + return sizeFixed64PackedSlice, appendFixed64PackedSlice + } + return sizeFixed64Slice, appendFixed64Slice + } + if nozero { + return sizeFixed64ValueNoZero, appendFixed64ValueNoZero + } + return sizeFixed64Value, appendFixed64Value + case "varint": + if pointer { + return sizeVarint64Ptr, appendVarint64Ptr + } + if slice { + if packed { + return sizeVarint64PackedSlice, appendVarint64PackedSlice + } + return sizeVarint64Slice, appendVarint64Slice + } + if nozero { + return sizeVarint64ValueNoZero, appendVarint64ValueNoZero + } + return sizeVarint64Value, appendVarint64Value + } + case reflect.Int64: + switch encoding { + case "fixed64": + if pointer { + return sizeFixedS64Ptr, appendFixedS64Ptr + } + if slice { + if packed { + return sizeFixedS64PackedSlice, appendFixedS64PackedSlice + } + return sizeFixedS64Slice, appendFixedS64Slice + } + if nozero { + return sizeFixedS64ValueNoZero, appendFixedS64ValueNoZero + } + return sizeFixedS64Value, appendFixedS64Value + case "varint": + if pointer { + return sizeVarintS64Ptr, appendVarintS64Ptr + } + if slice { + if packed { + return sizeVarintS64PackedSlice, appendVarintS64PackedSlice + } + return sizeVarintS64Slice, appendVarintS64Slice + } + if nozero { + return sizeVarintS64ValueNoZero, appendVarintS64ValueNoZero + } + return sizeVarintS64Value, appendVarintS64Value + case "zigzag64": + if pointer { + return sizeZigzag64Ptr, appendZigzag64Ptr + } + if slice { + if packed { + return sizeZigzag64PackedSlice, appendZigzag64PackedSlice + } + return sizeZigzag64Slice, appendZigzag64Slice + } + if nozero { + return sizeZigzag64ValueNoZero, appendZigzag64ValueNoZero + } + return sizeZigzag64Value, appendZigzag64Value + } + case reflect.Float32: + if pointer { + return sizeFloat32Ptr, appendFloat32Ptr + } + if slice { + if packed { + return sizeFloat32PackedSlice, appendFloat32PackedSlice + } + return sizeFloat32Slice, appendFloat32Slice + } + if nozero { + return sizeFloat32ValueNoZero, appendFloat32ValueNoZero + } + return sizeFloat32Value, appendFloat32Value + case reflect.Float64: + if pointer { + return sizeFloat64Ptr, appendFloat64Ptr + } + if slice { + if packed { + return sizeFloat64PackedSlice, appendFloat64PackedSlice + } + return sizeFloat64Slice, appendFloat64Slice + } + if nozero { + return sizeFloat64ValueNoZero, appendFloat64ValueNoZero + } + return sizeFloat64Value, appendFloat64Value + case reflect.String: + if pointer { + return sizeStringPtr, appendStringPtr + } + if slice { + return sizeStringSlice, appendStringSlice + } + if nozero { + return sizeStringValueNoZero, appendStringValueNoZero + } + return sizeStringValue, appendStringValue + case reflect.Slice: + if slice { + return sizeBytesSlice, appendBytesSlice + } + if oneof { + // Oneof bytes field may also have "proto3" tag. + // We want to marshal it as a oneof field. Do this + // check before the proto3 check. + return sizeBytesOneof, appendBytesOneof + } + if proto3 { + return sizeBytes3, appendBytes3 + } + return sizeBytes, appendBytes + case reflect.Struct: + switch encoding { + case "group": + if slice { + return makeGroupSliceMarshaler(getMarshalInfo(t)) + } + return makeGroupMarshaler(getMarshalInfo(t)) + case "bytes": + if pointer { + if slice { + return makeMessageSliceMarshaler(getMarshalInfo(t)) + } + return makeMessageMarshaler(getMarshalInfo(t)) + } else { + if slice { + return makeMessageRefSliceMarshaler(getMarshalInfo(t)) + } + return makeMessageRefMarshaler(getMarshalInfo(t)) + } + } + } + panic(fmt.Sprintf("unknown or mismatched type: type: %v, wire type: %v", t, encoding)) +} + +// Below are functions to size/marshal a specific type of a field. +// They are stored in the field's info, and called by function pointers. +// They have type sizer or marshaler. + +func sizeFixed32Value(_ pointer, tagsize int) int { + return 4 + tagsize +} +func sizeFixed32ValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toUint32() + if v == 0 { + return 0 + } + return 4 + tagsize +} +func sizeFixed32Ptr(ptr pointer, tagsize int) int { + p := *ptr.toUint32Ptr() + if p == nil { + return 0 + } + return 4 + tagsize +} +func sizeFixed32Slice(ptr pointer, tagsize int) int { + s := *ptr.toUint32Slice() + return (4 + tagsize) * len(s) +} +func sizeFixed32PackedSlice(ptr pointer, tagsize int) int { + s := *ptr.toUint32Slice() + if len(s) == 0 { + return 0 + } + return 4*len(s) + SizeVarint(uint64(4*len(s))) + tagsize +} +func sizeFixedS32Value(_ pointer, tagsize int) int { + return 4 + tagsize +} +func sizeFixedS32ValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toInt32() + if v == 0 { + return 0 + } + return 4 + tagsize +} +func sizeFixedS32Ptr(ptr pointer, tagsize int) int { + p := ptr.getInt32Ptr() + if p == nil { + return 0 + } + return 4 + tagsize +} +func sizeFixedS32Slice(ptr pointer, tagsize int) int { + s := ptr.getInt32Slice() + return (4 + tagsize) * len(s) +} +func sizeFixedS32PackedSlice(ptr pointer, tagsize int) int { + s := ptr.getInt32Slice() + if len(s) == 0 { + return 0 + } + return 4*len(s) + SizeVarint(uint64(4*len(s))) + tagsize +} +func sizeFloat32Value(_ pointer, tagsize int) int { + return 4 + tagsize +} +func sizeFloat32ValueNoZero(ptr pointer, tagsize int) int { + v := math.Float32bits(*ptr.toFloat32()) + if v == 0 { + return 0 + } + return 4 + tagsize +} +func sizeFloat32Ptr(ptr pointer, tagsize int) int { + p := *ptr.toFloat32Ptr() + if p == nil { + return 0 + } + return 4 + tagsize +} +func sizeFloat32Slice(ptr pointer, tagsize int) int { + s := *ptr.toFloat32Slice() + return (4 + tagsize) * len(s) +} +func sizeFloat32PackedSlice(ptr pointer, tagsize int) int { + s := *ptr.toFloat32Slice() + if len(s) == 0 { + return 0 + } + return 4*len(s) + SizeVarint(uint64(4*len(s))) + tagsize +} +func sizeFixed64Value(_ pointer, tagsize int) int { + return 8 + tagsize +} +func sizeFixed64ValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toUint64() + if v == 0 { + return 0 + } + return 8 + tagsize +} +func sizeFixed64Ptr(ptr pointer, tagsize int) int { + p := *ptr.toUint64Ptr() + if p == nil { + return 0 + } + return 8 + tagsize +} +func sizeFixed64Slice(ptr pointer, tagsize int) int { + s := *ptr.toUint64Slice() + return (8 + tagsize) * len(s) +} +func sizeFixed64PackedSlice(ptr pointer, tagsize int) int { + s := *ptr.toUint64Slice() + if len(s) == 0 { + return 0 + } + return 8*len(s) + SizeVarint(uint64(8*len(s))) + tagsize +} +func sizeFixedS64Value(_ pointer, tagsize int) int { + return 8 + tagsize +} +func sizeFixedS64ValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toInt64() + if v == 0 { + return 0 + } + return 8 + tagsize +} +func sizeFixedS64Ptr(ptr pointer, tagsize int) int { + p := *ptr.toInt64Ptr() + if p == nil { + return 0 + } + return 8 + tagsize +} +func sizeFixedS64Slice(ptr pointer, tagsize int) int { + s := *ptr.toInt64Slice() + return (8 + tagsize) * len(s) +} +func sizeFixedS64PackedSlice(ptr pointer, tagsize int) int { + s := *ptr.toInt64Slice() + if len(s) == 0 { + return 0 + } + return 8*len(s) + SizeVarint(uint64(8*len(s))) + tagsize +} +func sizeFloat64Value(_ pointer, tagsize int) int { + return 8 + tagsize +} +func sizeFloat64ValueNoZero(ptr pointer, tagsize int) int { + v := math.Float64bits(*ptr.toFloat64()) + if v == 0 { + return 0 + } + return 8 + tagsize +} +func sizeFloat64Ptr(ptr pointer, tagsize int) int { + p := *ptr.toFloat64Ptr() + if p == nil { + return 0 + } + return 8 + tagsize +} +func sizeFloat64Slice(ptr pointer, tagsize int) int { + s := *ptr.toFloat64Slice() + return (8 + tagsize) * len(s) +} +func sizeFloat64PackedSlice(ptr pointer, tagsize int) int { + s := *ptr.toFloat64Slice() + if len(s) == 0 { + return 0 + } + return 8*len(s) + SizeVarint(uint64(8*len(s))) + tagsize +} +func sizeVarint32Value(ptr pointer, tagsize int) int { + v := *ptr.toUint32() + return SizeVarint(uint64(v)) + tagsize +} +func sizeVarint32ValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toUint32() + if v == 0 { + return 0 + } + return SizeVarint(uint64(v)) + tagsize +} +func sizeVarint32Ptr(ptr pointer, tagsize int) int { + p := *ptr.toUint32Ptr() + if p == nil { + return 0 + } + return SizeVarint(uint64(*p)) + tagsize +} +func sizeVarint32Slice(ptr pointer, tagsize int) int { + s := *ptr.toUint32Slice() + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v)) + tagsize + } + return n +} +func sizeVarint32PackedSlice(ptr pointer, tagsize int) int { + s := *ptr.toUint32Slice() + if len(s) == 0 { + return 0 + } + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v)) + } + return n + SizeVarint(uint64(n)) + tagsize +} +func sizeVarintS32Value(ptr pointer, tagsize int) int { + v := *ptr.toInt32() + return SizeVarint(uint64(v)) + tagsize +} +func sizeVarintS32ValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toInt32() + if v == 0 { + return 0 + } + return SizeVarint(uint64(v)) + tagsize +} +func sizeVarintS32Ptr(ptr pointer, tagsize int) int { + p := ptr.getInt32Ptr() + if p == nil { + return 0 + } + return SizeVarint(uint64(*p)) + tagsize +} +func sizeVarintS32Slice(ptr pointer, tagsize int) int { + s := ptr.getInt32Slice() + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v)) + tagsize + } + return n +} +func sizeVarintS32PackedSlice(ptr pointer, tagsize int) int { + s := ptr.getInt32Slice() + if len(s) == 0 { + return 0 + } + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v)) + } + return n + SizeVarint(uint64(n)) + tagsize +} +func sizeVarint64Value(ptr pointer, tagsize int) int { + v := *ptr.toUint64() + return SizeVarint(v) + tagsize +} +func sizeVarint64ValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toUint64() + if v == 0 { + return 0 + } + return SizeVarint(v) + tagsize +} +func sizeVarint64Ptr(ptr pointer, tagsize int) int { + p := *ptr.toUint64Ptr() + if p == nil { + return 0 + } + return SizeVarint(*p) + tagsize +} +func sizeVarint64Slice(ptr pointer, tagsize int) int { + s := *ptr.toUint64Slice() + n := 0 + for _, v := range s { + n += SizeVarint(v) + tagsize + } + return n +} +func sizeVarint64PackedSlice(ptr pointer, tagsize int) int { + s := *ptr.toUint64Slice() + if len(s) == 0 { + return 0 + } + n := 0 + for _, v := range s { + n += SizeVarint(v) + } + return n + SizeVarint(uint64(n)) + tagsize +} +func sizeVarintS64Value(ptr pointer, tagsize int) int { + v := *ptr.toInt64() + return SizeVarint(uint64(v)) + tagsize +} +func sizeVarintS64ValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toInt64() + if v == 0 { + return 0 + } + return SizeVarint(uint64(v)) + tagsize +} +func sizeVarintS64Ptr(ptr pointer, tagsize int) int { + p := *ptr.toInt64Ptr() + if p == nil { + return 0 + } + return SizeVarint(uint64(*p)) + tagsize +} +func sizeVarintS64Slice(ptr pointer, tagsize int) int { + s := *ptr.toInt64Slice() + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v)) + tagsize + } + return n +} +func sizeVarintS64PackedSlice(ptr pointer, tagsize int) int { + s := *ptr.toInt64Slice() + if len(s) == 0 { + return 0 + } + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v)) + } + return n + SizeVarint(uint64(n)) + tagsize +} +func sizeZigzag32Value(ptr pointer, tagsize int) int { + v := *ptr.toInt32() + return SizeVarint(uint64((uint32(v)<<1)^uint32((int32(v)>>31)))) + tagsize +} +func sizeZigzag32ValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toInt32() + if v == 0 { + return 0 + } + return SizeVarint(uint64((uint32(v)<<1)^uint32((int32(v)>>31)))) + tagsize +} +func sizeZigzag32Ptr(ptr pointer, tagsize int) int { + p := ptr.getInt32Ptr() + if p == nil { + return 0 + } + v := *p + return SizeVarint(uint64((uint32(v)<<1)^uint32((int32(v)>>31)))) + tagsize +} +func sizeZigzag32Slice(ptr pointer, tagsize int) int { + s := ptr.getInt32Slice() + n := 0 + for _, v := range s { + n += SizeVarint(uint64((uint32(v)<<1)^uint32((int32(v)>>31)))) + tagsize + } + return n +} +func sizeZigzag32PackedSlice(ptr pointer, tagsize int) int { + s := ptr.getInt32Slice() + if len(s) == 0 { + return 0 + } + n := 0 + for _, v := range s { + n += SizeVarint(uint64((uint32(v) << 1) ^ uint32((int32(v) >> 31)))) + } + return n + SizeVarint(uint64(n)) + tagsize +} +func sizeZigzag64Value(ptr pointer, tagsize int) int { + v := *ptr.toInt64() + return SizeVarint(uint64(v<<1)^uint64((int64(v)>>63))) + tagsize +} +func sizeZigzag64ValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toInt64() + if v == 0 { + return 0 + } + return SizeVarint(uint64(v<<1)^uint64((int64(v)>>63))) + tagsize +} +func sizeZigzag64Ptr(ptr pointer, tagsize int) int { + p := *ptr.toInt64Ptr() + if p == nil { + return 0 + } + v := *p + return SizeVarint(uint64(v<<1)^uint64((int64(v)>>63))) + tagsize +} +func sizeZigzag64Slice(ptr pointer, tagsize int) int { + s := *ptr.toInt64Slice() + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v<<1)^uint64((int64(v)>>63))) + tagsize + } + return n +} +func sizeZigzag64PackedSlice(ptr pointer, tagsize int) int { + s := *ptr.toInt64Slice() + if len(s) == 0 { + return 0 + } + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v<<1) ^ uint64((int64(v) >> 63))) + } + return n + SizeVarint(uint64(n)) + tagsize +} +func sizeBoolValue(_ pointer, tagsize int) int { + return 1 + tagsize +} +func sizeBoolValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toBool() + if !v { + return 0 + } + return 1 + tagsize +} +func sizeBoolPtr(ptr pointer, tagsize int) int { + p := *ptr.toBoolPtr() + if p == nil { + return 0 + } + return 1 + tagsize +} +func sizeBoolSlice(ptr pointer, tagsize int) int { + s := *ptr.toBoolSlice() + return (1 + tagsize) * len(s) +} +func sizeBoolPackedSlice(ptr pointer, tagsize int) int { + s := *ptr.toBoolSlice() + if len(s) == 0 { + return 0 + } + return len(s) + SizeVarint(uint64(len(s))) + tagsize +} +func sizeStringValue(ptr pointer, tagsize int) int { + v := *ptr.toString() + return len(v) + SizeVarint(uint64(len(v))) + tagsize +} +func sizeStringValueNoZero(ptr pointer, tagsize int) int { + v := *ptr.toString() + if v == "" { + return 0 + } + return len(v) + SizeVarint(uint64(len(v))) + tagsize +} +func sizeStringPtr(ptr pointer, tagsize int) int { + p := *ptr.toStringPtr() + if p == nil { + return 0 + } + v := *p + return len(v) + SizeVarint(uint64(len(v))) + tagsize +} +func sizeStringSlice(ptr pointer, tagsize int) int { + s := *ptr.toStringSlice() + n := 0 + for _, v := range s { + n += len(v) + SizeVarint(uint64(len(v))) + tagsize + } + return n +} +func sizeBytes(ptr pointer, tagsize int) int { + v := *ptr.toBytes() + if v == nil { + return 0 + } + return len(v) + SizeVarint(uint64(len(v))) + tagsize +} +func sizeBytes3(ptr pointer, tagsize int) int { + v := *ptr.toBytes() + if len(v) == 0 { + return 0 + } + return len(v) + SizeVarint(uint64(len(v))) + tagsize +} +func sizeBytesOneof(ptr pointer, tagsize int) int { + v := *ptr.toBytes() + return len(v) + SizeVarint(uint64(len(v))) + tagsize +} +func sizeBytesSlice(ptr pointer, tagsize int) int { + s := *ptr.toBytesSlice() + n := 0 + for _, v := range s { + n += len(v) + SizeVarint(uint64(len(v))) + tagsize + } + return n +} + +// appendFixed32 appends an encoded fixed32 to b. +func appendFixed32(b []byte, v uint32) []byte { + b = append(b, + byte(v), + byte(v>>8), + byte(v>>16), + byte(v>>24)) + return b +} + +// appendFixed64 appends an encoded fixed64 to b. +func appendFixed64(b []byte, v uint64) []byte { + b = append(b, + byte(v), + byte(v>>8), + byte(v>>16), + byte(v>>24), + byte(v>>32), + byte(v>>40), + byte(v>>48), + byte(v>>56)) + return b +} + +// appendVarint appends an encoded varint to b. +func appendVarint(b []byte, v uint64) []byte { + // TODO: make 1-byte (maybe 2-byte) case inline-able, once we + // have non-leaf inliner. + switch { + case v < 1<<7: + b = append(b, byte(v)) + case v < 1<<14: + b = append(b, + byte(v&0x7f|0x80), + byte(v>>7)) + case v < 1<<21: + b = append(b, + byte(v&0x7f|0x80), + byte((v>>7)&0x7f|0x80), + byte(v>>14)) + case v < 1<<28: + b = append(b, + byte(v&0x7f|0x80), + byte((v>>7)&0x7f|0x80), + byte((v>>14)&0x7f|0x80), + byte(v>>21)) + case v < 1<<35: + b = append(b, + byte(v&0x7f|0x80), + byte((v>>7)&0x7f|0x80), + byte((v>>14)&0x7f|0x80), + byte((v>>21)&0x7f|0x80), + byte(v>>28)) + case v < 1<<42: + b = append(b, + byte(v&0x7f|0x80), + byte((v>>7)&0x7f|0x80), + byte((v>>14)&0x7f|0x80), + byte((v>>21)&0x7f|0x80), + byte((v>>28)&0x7f|0x80), + byte(v>>35)) + case v < 1<<49: + b = append(b, + byte(v&0x7f|0x80), + byte((v>>7)&0x7f|0x80), + byte((v>>14)&0x7f|0x80), + byte((v>>21)&0x7f|0x80), + byte((v>>28)&0x7f|0x80), + byte((v>>35)&0x7f|0x80), + byte(v>>42)) + case v < 1<<56: + b = append(b, + byte(v&0x7f|0x80), + byte((v>>7)&0x7f|0x80), + byte((v>>14)&0x7f|0x80), + byte((v>>21)&0x7f|0x80), + byte((v>>28)&0x7f|0x80), + byte((v>>35)&0x7f|0x80), + byte((v>>42)&0x7f|0x80), + byte(v>>49)) + case v < 1<<63: + b = append(b, + byte(v&0x7f|0x80), + byte((v>>7)&0x7f|0x80), + byte((v>>14)&0x7f|0x80), + byte((v>>21)&0x7f|0x80), + byte((v>>28)&0x7f|0x80), + byte((v>>35)&0x7f|0x80), + byte((v>>42)&0x7f|0x80), + byte((v>>49)&0x7f|0x80), + byte(v>>56)) + default: + b = append(b, + byte(v&0x7f|0x80), + byte((v>>7)&0x7f|0x80), + byte((v>>14)&0x7f|0x80), + byte((v>>21)&0x7f|0x80), + byte((v>>28)&0x7f|0x80), + byte((v>>35)&0x7f|0x80), + byte((v>>42)&0x7f|0x80), + byte((v>>49)&0x7f|0x80), + byte((v>>56)&0x7f|0x80), + 1) + } + return b +} + +func appendFixed32Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toUint32() + b = appendVarint(b, wiretag) + b = appendFixed32(b, v) + return b, nil +} +func appendFixed32ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toUint32() + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed32(b, v) + return b, nil +} +func appendFixed32Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toUint32Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed32(b, *p) + return b, nil +} +func appendFixed32Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toUint32Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendFixed32(b, v) + } + return b, nil +} +func appendFixed32PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toUint32Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + b = appendVarint(b, uint64(4*len(s))) + for _, v := range s { + b = appendFixed32(b, v) + } + return b, nil +} +func appendFixedS32Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt32() + b = appendVarint(b, wiretag) + b = appendFixed32(b, uint32(v)) + return b, nil +} +func appendFixedS32ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt32() + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed32(b, uint32(v)) + return b, nil +} +func appendFixedS32Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := ptr.getInt32Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed32(b, uint32(*p)) + return b, nil +} +func appendFixedS32Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := ptr.getInt32Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendFixed32(b, uint32(v)) + } + return b, nil +} +func appendFixedS32PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := ptr.getInt32Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + b = appendVarint(b, uint64(4*len(s))) + for _, v := range s { + b = appendFixed32(b, uint32(v)) + } + return b, nil +} +func appendFloat32Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := math.Float32bits(*ptr.toFloat32()) + b = appendVarint(b, wiretag) + b = appendFixed32(b, v) + return b, nil +} +func appendFloat32ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := math.Float32bits(*ptr.toFloat32()) + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed32(b, v) + return b, nil +} +func appendFloat32Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toFloat32Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed32(b, math.Float32bits(*p)) + return b, nil +} +func appendFloat32Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toFloat32Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendFixed32(b, math.Float32bits(v)) + } + return b, nil +} +func appendFloat32PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toFloat32Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + b = appendVarint(b, uint64(4*len(s))) + for _, v := range s { + b = appendFixed32(b, math.Float32bits(v)) + } + return b, nil +} +func appendFixed64Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toUint64() + b = appendVarint(b, wiretag) + b = appendFixed64(b, v) + return b, nil +} +func appendFixed64ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toUint64() + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed64(b, v) + return b, nil +} +func appendFixed64Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toUint64Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed64(b, *p) + return b, nil +} +func appendFixed64Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toUint64Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendFixed64(b, v) + } + return b, nil +} +func appendFixed64PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toUint64Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + b = appendVarint(b, uint64(8*len(s))) + for _, v := range s { + b = appendFixed64(b, v) + } + return b, nil +} +func appendFixedS64Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt64() + b = appendVarint(b, wiretag) + b = appendFixed64(b, uint64(v)) + return b, nil +} +func appendFixedS64ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt64() + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed64(b, uint64(v)) + return b, nil +} +func appendFixedS64Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toInt64Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed64(b, uint64(*p)) + return b, nil +} +func appendFixedS64Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toInt64Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendFixed64(b, uint64(v)) + } + return b, nil +} +func appendFixedS64PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toInt64Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + b = appendVarint(b, uint64(8*len(s))) + for _, v := range s { + b = appendFixed64(b, uint64(v)) + } + return b, nil +} +func appendFloat64Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := math.Float64bits(*ptr.toFloat64()) + b = appendVarint(b, wiretag) + b = appendFixed64(b, v) + return b, nil +} +func appendFloat64ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := math.Float64bits(*ptr.toFloat64()) + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed64(b, v) + return b, nil +} +func appendFloat64Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toFloat64Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendFixed64(b, math.Float64bits(*p)) + return b, nil +} +func appendFloat64Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toFloat64Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendFixed64(b, math.Float64bits(v)) + } + return b, nil +} +func appendFloat64PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toFloat64Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + b = appendVarint(b, uint64(8*len(s))) + for _, v := range s { + b = appendFixed64(b, math.Float64bits(v)) + } + return b, nil +} +func appendVarint32Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toUint32() + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v)) + return b, nil +} +func appendVarint32ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toUint32() + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v)) + return b, nil +} +func appendVarint32Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toUint32Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(*p)) + return b, nil +} +func appendVarint32Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toUint32Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v)) + } + return b, nil +} +func appendVarint32PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toUint32Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + // compute size + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v)) + } + b = appendVarint(b, uint64(n)) + for _, v := range s { + b = appendVarint(b, uint64(v)) + } + return b, nil +} +func appendVarintS32Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt32() + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v)) + return b, nil +} +func appendVarintS32ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt32() + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v)) + return b, nil +} +func appendVarintS32Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := ptr.getInt32Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(*p)) + return b, nil +} +func appendVarintS32Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := ptr.getInt32Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v)) + } + return b, nil +} +func appendVarintS32PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := ptr.getInt32Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + // compute size + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v)) + } + b = appendVarint(b, uint64(n)) + for _, v := range s { + b = appendVarint(b, uint64(v)) + } + return b, nil +} +func appendVarint64Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toUint64() + b = appendVarint(b, wiretag) + b = appendVarint(b, v) + return b, nil +} +func appendVarint64ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toUint64() + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, v) + return b, nil +} +func appendVarint64Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toUint64Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, *p) + return b, nil +} +func appendVarint64Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toUint64Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendVarint(b, v) + } + return b, nil +} +func appendVarint64PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toUint64Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + // compute size + n := 0 + for _, v := range s { + n += SizeVarint(v) + } + b = appendVarint(b, uint64(n)) + for _, v := range s { + b = appendVarint(b, v) + } + return b, nil +} +func appendVarintS64Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt64() + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v)) + return b, nil +} +func appendVarintS64ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt64() + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v)) + return b, nil +} +func appendVarintS64Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toInt64Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(*p)) + return b, nil +} +func appendVarintS64Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toInt64Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v)) + } + return b, nil +} +func appendVarintS64PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toInt64Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + // compute size + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v)) + } + b = appendVarint(b, uint64(n)) + for _, v := range s { + b = appendVarint(b, uint64(v)) + } + return b, nil +} +func appendZigzag32Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt32() + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64((uint32(v)<<1)^uint32((int32(v)>>31)))) + return b, nil +} +func appendZigzag32ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt32() + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64((uint32(v)<<1)^uint32((int32(v)>>31)))) + return b, nil +} +func appendZigzag32Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := ptr.getInt32Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + v := *p + b = appendVarint(b, uint64((uint32(v)<<1)^uint32((int32(v)>>31)))) + return b, nil +} +func appendZigzag32Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := ptr.getInt32Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64((uint32(v)<<1)^uint32((int32(v)>>31)))) + } + return b, nil +} +func appendZigzag32PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := ptr.getInt32Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + // compute size + n := 0 + for _, v := range s { + n += SizeVarint(uint64((uint32(v) << 1) ^ uint32((int32(v) >> 31)))) + } + b = appendVarint(b, uint64(n)) + for _, v := range s { + b = appendVarint(b, uint64((uint32(v)<<1)^uint32((int32(v)>>31)))) + } + return b, nil +} +func appendZigzag64Value(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt64() + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v<<1)^uint64((int64(v)>>63))) + return b, nil +} +func appendZigzag64ValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toInt64() + if v == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v<<1)^uint64((int64(v)>>63))) + return b, nil +} +func appendZigzag64Ptr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toInt64Ptr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + v := *p + b = appendVarint(b, uint64(v<<1)^uint64((int64(v)>>63))) + return b, nil +} +func appendZigzag64Slice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toInt64Slice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(v<<1)^uint64((int64(v)>>63))) + } + return b, nil +} +func appendZigzag64PackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toInt64Slice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + // compute size + n := 0 + for _, v := range s { + n += SizeVarint(uint64(v<<1) ^ uint64((int64(v) >> 63))) + } + b = appendVarint(b, uint64(n)) + for _, v := range s { + b = appendVarint(b, uint64(v<<1)^uint64((int64(v)>>63))) + } + return b, nil +} +func appendBoolValue(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toBool() + b = appendVarint(b, wiretag) + if v { + b = append(b, 1) + } else { + b = append(b, 0) + } + return b, nil +} +func appendBoolValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toBool() + if !v { + return b, nil + } + b = appendVarint(b, wiretag) + b = append(b, 1) + return b, nil +} + +func appendBoolPtr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toBoolPtr() + if p == nil { + return b, nil + } + b = appendVarint(b, wiretag) + if *p { + b = append(b, 1) + } else { + b = append(b, 0) + } + return b, nil +} +func appendBoolSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toBoolSlice() + for _, v := range s { + b = appendVarint(b, wiretag) + if v { + b = append(b, 1) + } else { + b = append(b, 0) + } + } + return b, nil +} +func appendBoolPackedSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toBoolSlice() + if len(s) == 0 { + return b, nil + } + b = appendVarint(b, wiretag&^7|WireBytes) + b = appendVarint(b, uint64(len(s))) + for _, v := range s { + if v { + b = append(b, 1) + } else { + b = append(b, 0) + } + } + return b, nil +} +func appendStringValue(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toString() + if !utf8.ValidString(v) { + return nil, errInvalidUTF8 + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(v))) + b = append(b, v...) + return b, nil +} +func appendStringValueNoZero(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toString() + if v == "" { + return b, nil + } + if !utf8.ValidString(v) { + return nil, errInvalidUTF8 + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(v))) + b = append(b, v...) + return b, nil +} +func appendStringPtr(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + p := *ptr.toStringPtr() + if p == nil { + return b, nil + } + v := *p + if !utf8.ValidString(v) { + return nil, errInvalidUTF8 + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(v))) + b = append(b, v...) + return b, nil +} +func appendStringSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toStringSlice() + for _, v := range s { + if !utf8.ValidString(v) { + return nil, errInvalidUTF8 + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(v))) + b = append(b, v...) + } + return b, nil +} +func appendBytes(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toBytes() + if v == nil { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(v))) + b = append(b, v...) + return b, nil +} +func appendBytes3(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toBytes() + if len(v) == 0 { + return b, nil + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(v))) + b = append(b, v...) + return b, nil +} +func appendBytesOneof(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + v := *ptr.toBytes() + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(v))) + b = append(b, v...) + return b, nil +} +func appendBytesSlice(b []byte, ptr pointer, wiretag uint64, _ bool) ([]byte, error) { + s := *ptr.toBytesSlice() + for _, v := range s { + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(v))) + b = append(b, v...) + } + return b, nil +} + +// makeGroupMarshaler returns the sizer and marshaler for a group. +// u is the marshal info of the underlying message. +func makeGroupMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + p := ptr.getPointer() + if p.isNil() { + return 0 + } + return u.size(p) + 2*tagsize + }, + func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + p := ptr.getPointer() + if p.isNil() { + return b, nil + } + var err error + b = appendVarint(b, wiretag) // start group + b, err = u.marshal(b, p, deterministic) + b = appendVarint(b, wiretag+(WireEndGroup-WireStartGroup)) // end group + return b, err + } +} + +// makeGroupSliceMarshaler returns the sizer and marshaler for a group slice. +// u is the marshal info of the underlying message. +func makeGroupSliceMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + s := ptr.getPointerSlice() + n := 0 + for _, v := range s { + if v.isNil() { + continue + } + n += u.size(v) + 2*tagsize + } + return n + }, + func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + s := ptr.getPointerSlice() + var err, errreq error + for _, v := range s { + if v.isNil() { + return b, errRepeatedHasNil + } + b = appendVarint(b, wiretag) // start group + b, err = u.marshal(b, v, deterministic) + b = appendVarint(b, wiretag+(WireEndGroup-WireStartGroup)) // end group + if err != nil { + if _, ok := err.(*RequiredNotSetError); ok { + // Required field in submessage is not set. + // We record the error but keep going, to give a complete marshaling. + if errreq == nil { + errreq = err + } + continue + } + if err == ErrNil { + err = errRepeatedHasNil + } + return b, err + } + } + return b, errreq + } +} + +// makeMessageMarshaler returns the sizer and marshaler for a message field. +// u is the marshal info of the message. +func makeMessageMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + p := ptr.getPointer() + if p.isNil() { + return 0 + } + siz := u.size(p) + return siz + SizeVarint(uint64(siz)) + tagsize + }, + func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + p := ptr.getPointer() + if p.isNil() { + return b, nil + } + b = appendVarint(b, wiretag) + siz := u.cachedsize(p) + b = appendVarint(b, uint64(siz)) + return u.marshal(b, p, deterministic) + } +} + +// makeMessageSliceMarshaler returns the sizer and marshaler for a message slice. +// u is the marshal info of the message. +func makeMessageSliceMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + s := ptr.getPointerSlice() + n := 0 + for _, v := range s { + if v.isNil() { + continue + } + siz := u.size(v) + n += siz + SizeVarint(uint64(siz)) + tagsize + } + return n + }, + func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + s := ptr.getPointerSlice() + var err, errreq error + for _, v := range s { + if v.isNil() { + return b, errRepeatedHasNil + } + b = appendVarint(b, wiretag) + siz := u.cachedsize(v) + b = appendVarint(b, uint64(siz)) + b, err = u.marshal(b, v, deterministic) + if err != nil { + if _, ok := err.(*RequiredNotSetError); ok { + // Required field in submessage is not set. + // We record the error but keep going, to give a complete marshaling. + if errreq == nil { + errreq = err + } + continue + } + if err == ErrNil { + err = errRepeatedHasNil + } + return b, err + } + } + return b, errreq + } +} + +// makeMapMarshaler returns the sizer and marshaler for a map field. +// f is the pointer to the reflect data structure of the field. +func makeMapMarshaler(f *reflect.StructField) (sizer, marshaler) { + // figure out key and value type + t := f.Type + keyType := t.Key() + valType := t.Elem() + tags := strings.Split(f.Tag.Get("protobuf"), ",") + keyTags := strings.Split(f.Tag.Get("protobuf_key"), ",") + valTags := strings.Split(f.Tag.Get("protobuf_val"), ",") + for _, t := range tags { + if strings.HasPrefix(t, "customtype=") { + valTags = append(valTags, t) + } + if t == "stdtime" { + valTags = append(valTags, t) + } + if t == "stdduration" { + valTags = append(valTags, t) + } + } + keySizer, keyMarshaler := typeMarshaler(keyType, keyTags, false, false) // don't omit zero value in map + valSizer, valMarshaler := typeMarshaler(valType, valTags, false, false) // don't omit zero value in map + keyWireTag := 1<<3 | wiretype(keyTags[0]) + valWireTag := 2<<3 | wiretype(valTags[0]) + + // We create an interface to get the addresses of the map key and value. + // If value is pointer-typed, the interface is a direct interface, the + // idata itself is the value. Otherwise, the idata is the pointer to the + // value. + // Key cannot be pointer-typed. + valIsPtr := valType.Kind() == reflect.Ptr + return func(ptr pointer, tagsize int) int { + m := ptr.asPointerTo(t).Elem() // the map + n := 0 + for _, k := range m.MapKeys() { + ki := k.Interface() + vi := m.MapIndex(k).Interface() + kaddr := toAddrPointer(&ki, false) // pointer to key + vaddr := toAddrPointer(&vi, valIsPtr) // pointer to value + siz := keySizer(kaddr, 1) + valSizer(vaddr, 1) // tag of key = 1 (size=1), tag of val = 2 (size=1) + n += siz + SizeVarint(uint64(siz)) + tagsize + } + return n + }, + func(b []byte, ptr pointer, tag uint64, deterministic bool) ([]byte, error) { + m := ptr.asPointerTo(t).Elem() // the map + var err error + keys := m.MapKeys() + if len(keys) > 1 && deterministic { + sort.Sort(mapKeys(keys)) + } + for _, k := range keys { + ki := k.Interface() + vi := m.MapIndex(k).Interface() + kaddr := toAddrPointer(&ki, false) // pointer to key + vaddr := toAddrPointer(&vi, valIsPtr) // pointer to value + b = appendVarint(b, tag) + siz := keySizer(kaddr, 1) + valSizer(vaddr, 1) // tag of key = 1 (size=1), tag of val = 2 (size=1) + b = appendVarint(b, uint64(siz)) + b, err = keyMarshaler(b, kaddr, keyWireTag, deterministic) + if err != nil { + return b, err + } + b, err = valMarshaler(b, vaddr, valWireTag, deterministic) + if err != nil && err != ErrNil { // allow nil value in map + return b, err + } + } + return b, nil + } +} + +// makeOneOfMarshaler returns the sizer and marshaler for a oneof field. +// fi is the marshal info of the field. +// f is the pointer to the reflect data structure of the field. +func makeOneOfMarshaler(fi *marshalFieldInfo, f *reflect.StructField) (sizer, marshaler) { + // Oneof field is an interface. We need to get the actual data type on the fly. + t := f.Type + return func(ptr pointer, _ int) int { + p := ptr.getInterfacePointer() + if p.isNil() { + return 0 + } + v := ptr.asPointerTo(t).Elem().Elem().Elem() // *interface -> interface -> *struct -> struct + telem := v.Type() + e := fi.oneofElems[telem] + return e.sizer(p, e.tagsize) + }, + func(b []byte, ptr pointer, _ uint64, deterministic bool) ([]byte, error) { + p := ptr.getInterfacePointer() + if p.isNil() { + return b, nil + } + v := ptr.asPointerTo(t).Elem().Elem().Elem() // *interface -> interface -> *struct -> struct + telem := v.Type() + if telem.Field(0).Type.Kind() == reflect.Ptr && p.getPointer().isNil() { + return b, errOneofHasNil + } + e := fi.oneofElems[telem] + return e.marshaler(b, p, e.wiretag, deterministic) + } +} + +// sizeExtensions computes the size of encoded data for a XXX_InternalExtensions field. +func (u *marshalInfo) sizeExtensions(ext *XXX_InternalExtensions) int { + m, mu := ext.extensionsRead() + if m == nil { + return 0 + } + mu.Lock() + + n := 0 + for _, e := range m { + if e.value == nil || e.desc == nil { + // Extension is only in its encoded form. + n += len(e.enc) + continue + } + + // We don't skip extensions that have an encoded form set, + // because the extension value may have been mutated after + // the last time this function was called. + ei := u.getExtElemInfo(e.desc) + v := e.value + p := toAddrPointer(&v, ei.isptr) + n += ei.sizer(p, ei.tagsize) + } + mu.Unlock() + return n +} + +// appendExtensions marshals a XXX_InternalExtensions field to the end of byte slice b. +func (u *marshalInfo) appendExtensions(b []byte, ext *XXX_InternalExtensions, deterministic bool) ([]byte, error) { + m, mu := ext.extensionsRead() + if m == nil { + return b, nil + } + mu.Lock() + defer mu.Unlock() + + var err error + + // Fast-path for common cases: zero or one extensions. + // Don't bother sorting the keys. + if len(m) <= 1 { + for _, e := range m { + if e.value == nil || e.desc == nil { + // Extension is only in its encoded form. + b = append(b, e.enc...) + continue + } + + // We don't skip extensions that have an encoded form set, + // because the extension value may have been mutated after + // the last time this function was called. + + ei := u.getExtElemInfo(e.desc) + v := e.value + p := toAddrPointer(&v, ei.isptr) + b, err = ei.marshaler(b, p, ei.wiretag, deterministic) + if err != nil { + return b, err + } + } + return b, nil + } + + // Sort the keys to provide a deterministic encoding. + // Not sure this is required, but the old code does it. + keys := make([]int, 0, len(m)) + for k := range m { + keys = append(keys, int(k)) + } + sort.Ints(keys) + + for _, k := range keys { + e := m[int32(k)] + if e.value == nil || e.desc == nil { + // Extension is only in its encoded form. + b = append(b, e.enc...) + continue + } + + // We don't skip extensions that have an encoded form set, + // because the extension value may have been mutated after + // the last time this function was called. + + ei := u.getExtElemInfo(e.desc) + v := e.value + p := toAddrPointer(&v, ei.isptr) + b, err = ei.marshaler(b, p, ei.wiretag, deterministic) + if err != nil { + return b, err + } + } + return b, nil +} + +// message set format is: +// message MessageSet { +// repeated group Item = 1 { +// required int32 type_id = 2; +// required string message = 3; +// }; +// } + +// sizeMessageSet computes the size of encoded data for a XXX_InternalExtensions field +// in message set format (above). +func (u *marshalInfo) sizeMessageSet(ext *XXX_InternalExtensions) int { + m, mu := ext.extensionsRead() + if m == nil { + return 0 + } + mu.Lock() + + n := 0 + for id, e := range m { + n += 2 // start group, end group. tag = 1 (size=1) + n += SizeVarint(uint64(id)) + 1 // type_id, tag = 2 (size=1) + + if e.value == nil || e.desc == nil { + // Extension is only in its encoded form. + msgWithLen := skipVarint(e.enc) // skip old tag, but leave the length varint + siz := len(msgWithLen) + n += siz + 1 // message, tag = 3 (size=1) + continue + } + + // We don't skip extensions that have an encoded form set, + // because the extension value may have been mutated after + // the last time this function was called. + + ei := u.getExtElemInfo(e.desc) + v := e.value + p := toAddrPointer(&v, ei.isptr) + n += ei.sizer(p, 1) // message, tag = 3 (size=1) + } + mu.Unlock() + return n +} + +// appendMessageSet marshals a XXX_InternalExtensions field in message set format (above) +// to the end of byte slice b. +func (u *marshalInfo) appendMessageSet(b []byte, ext *XXX_InternalExtensions, deterministic bool) ([]byte, error) { + m, mu := ext.extensionsRead() + if m == nil { + return b, nil + } + mu.Lock() + defer mu.Unlock() + + var err error + + // Fast-path for common cases: zero or one extensions. + // Don't bother sorting the keys. + if len(m) <= 1 { + for id, e := range m { + b = append(b, 1<<3|WireStartGroup) + b = append(b, 2<<3|WireVarint) + b = appendVarint(b, uint64(id)) + + if e.value == nil || e.desc == nil { + // Extension is only in its encoded form. + msgWithLen := skipVarint(e.enc) // skip old tag, but leave the length varint + b = append(b, 3<<3|WireBytes) + b = append(b, msgWithLen...) + b = append(b, 1<<3|WireEndGroup) + continue + } + + // We don't skip extensions that have an encoded form set, + // because the extension value may have been mutated after + // the last time this function was called. + + ei := u.getExtElemInfo(e.desc) + v := e.value + p := toAddrPointer(&v, ei.isptr) + b, err = ei.marshaler(b, p, 3<<3|WireBytes, deterministic) + if err != nil { + return b, err + } + b = append(b, 1<<3|WireEndGroup) + } + return b, nil + } + + // Sort the keys to provide a deterministic encoding. + keys := make([]int, 0, len(m)) + for k := range m { + keys = append(keys, int(k)) + } + sort.Ints(keys) + + for _, id := range keys { + e := m[int32(id)] + b = append(b, 1<<3|WireStartGroup) + b = append(b, 2<<3|WireVarint) + b = appendVarint(b, uint64(id)) + + if e.value == nil || e.desc == nil { + // Extension is only in its encoded form. + msgWithLen := skipVarint(e.enc) // skip old tag, but leave the length varint + b = append(b, 3<<3|WireBytes) + b = append(b, msgWithLen...) + b = append(b, 1<<3|WireEndGroup) + continue + } + + // We don't skip extensions that have an encoded form set, + // because the extension value may have been mutated after + // the last time this function was called. + + ei := u.getExtElemInfo(e.desc) + v := e.value + p := toAddrPointer(&v, ei.isptr) + b, err = ei.marshaler(b, p, 3<<3|WireBytes, deterministic) + b = append(b, 1<<3|WireEndGroup) + if err != nil { + return b, err + } + } + return b, nil +} + +// sizeV1Extensions computes the size of encoded data for a V1-API extension field. +func (u *marshalInfo) sizeV1Extensions(m map[int32]Extension) int { + if m == nil { + return 0 + } + + n := 0 + for _, e := range m { + if e.value == nil || e.desc == nil { + // Extension is only in its encoded form. + n += len(e.enc) + continue + } + + // We don't skip extensions that have an encoded form set, + // because the extension value may have been mutated after + // the last time this function was called. + + ei := u.getExtElemInfo(e.desc) + v := e.value + p := toAddrPointer(&v, ei.isptr) + n += ei.sizer(p, ei.tagsize) + } + return n +} + +// appendV1Extensions marshals a V1-API extension field to the end of byte slice b. +func (u *marshalInfo) appendV1Extensions(b []byte, m map[int32]Extension, deterministic bool) ([]byte, error) { + if m == nil { + return b, nil + } + + // Sort the keys to provide a deterministic encoding. + keys := make([]int, 0, len(m)) + for k := range m { + keys = append(keys, int(k)) + } + sort.Ints(keys) + + var err error + for _, k := range keys { + e := m[int32(k)] + if e.value == nil || e.desc == nil { + // Extension is only in its encoded form. + b = append(b, e.enc...) + continue + } + + // We don't skip extensions that have an encoded form set, + // because the extension value may have been mutated after + // the last time this function was called. + + ei := u.getExtElemInfo(e.desc) + v := e.value + p := toAddrPointer(&v, ei.isptr) + b, err = ei.marshaler(b, p, ei.wiretag, deterministic) + if err != nil { + return b, err + } + } + return b, nil +} + +// newMarshaler is the interface representing objects that can marshal themselves. +// +// This exists to support protoc-gen-go generated messages. +// The proto package will stop type-asserting to this interface in the future. +// +// DO NOT DEPEND ON THIS. +type newMarshaler interface { + XXX_Size() int + XXX_Marshal(b []byte, deterministic bool) ([]byte, error) +} + +// Size returns the encoded size of a protocol buffer message. +// This is the main entry point. +func Size(pb Message) int { + if m, ok := pb.(newMarshaler); ok { + return m.XXX_Size() + } + if m, ok := pb.(Marshaler); ok { + // If the message can marshal itself, let it do it, for compatibility. + // NOTE: This is not efficient. + b, _ := m.Marshal() + return len(b) + } + // in case somehow we didn't generate the wrapper + if pb == nil { + return 0 + } + var info InternalMessageInfo + return info.Size(pb) +} + +// Marshal takes a protocol buffer message +// and encodes it into the wire format, returning the data. +// This is the main entry point. +func Marshal(pb Message) ([]byte, error) { + if m, ok := pb.(newMarshaler); ok { + siz := m.XXX_Size() + b := make([]byte, 0, siz) + return m.XXX_Marshal(b, false) + } + if m, ok := pb.(Marshaler); ok { + // If the message can marshal itself, let it do it, for compatibility. + // NOTE: This is not efficient. + return m.Marshal() + } + // in case somehow we didn't generate the wrapper + if pb == nil { + return nil, ErrNil + } + var info InternalMessageInfo + siz := info.Size(pb) + b := make([]byte, 0, siz) + return info.Marshal(b, pb, false) +} + +// Marshal takes a protocol buffer message +// and encodes it into the wire format, writing the result to the +// Buffer. +// This is an alternative entry point. It is not necessary to use +// a Buffer for most applications. +func (p *Buffer) Marshal(pb Message) error { + var err error + if m, ok := pb.(newMarshaler); ok { + siz := m.XXX_Size() + p.grow(siz) // make sure buf has enough capacity + p.buf, err = m.XXX_Marshal(p.buf, p.deterministic) + return err + } + if m, ok := pb.(Marshaler); ok { + // If the message can marshal itself, let it do it, for compatibility. + // NOTE: This is not efficient. + var b []byte + b, err = m.Marshal() + p.buf = append(p.buf, b...) + return err + } + // in case somehow we didn't generate the wrapper + if pb == nil { + return ErrNil + } + var info InternalMessageInfo + siz := info.Size(pb) + p.grow(siz) // make sure buf has enough capacity + p.buf, err = info.Marshal(p.buf, pb, p.deterministic) + return err +} + +// grow grows the buffer's capacity, if necessary, to guarantee space for +// another n bytes. After grow(n), at least n bytes can be written to the +// buffer without another allocation. +func (p *Buffer) grow(n int) { + need := len(p.buf) + n + if need <= cap(p.buf) { + return + } + newCap := len(p.buf) * 2 + if newCap < need { + newCap = need + } + p.buf = append(make([]byte, 0, newCap), p.buf...) +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/table_marshal_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/table_marshal_gogo.go new file mode 100644 index 000000000000..997f57c1e102 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/table_marshal_gogo.go @@ -0,0 +1,388 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2018, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "reflect" + "time" +) + +// makeMessageRefMarshaler differs a bit from makeMessageMarshaler +// It marshal a message T instead of a *T +func makeMessageRefMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + siz := u.size(ptr) + return siz + SizeVarint(uint64(siz)) + tagsize + }, + func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + b = appendVarint(b, wiretag) + siz := u.cachedsize(ptr) + b = appendVarint(b, uint64(siz)) + return u.marshal(b, ptr, deterministic) + } +} + +// makeMessageRefSliceMarshaler differs quite a lot from makeMessageSliceMarshaler +// It marshals a slice of messages []T instead of []*T +func makeMessageRefSliceMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + s := ptr.getSlice(u.typ) + n := 0 + for i := 0; i < s.Len(); i++ { + elem := s.Index(i) + e := elem.Interface() + v := toAddrPointer(&e, false) + siz := u.size(v) + n += siz + SizeVarint(uint64(siz)) + tagsize + } + return n + }, + func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + s := ptr.getSlice(u.typ) + var err, errreq error + for i := 0; i < s.Len(); i++ { + elem := s.Index(i) + e := elem.Interface() + v := toAddrPointer(&e, false) + b = appendVarint(b, wiretag) + siz := u.size(v) + b = appendVarint(b, uint64(siz)) + b, err = u.marshal(b, v, deterministic) + + if err != nil { + if _, ok := err.(*RequiredNotSetError); ok { + // Required field in submessage is not set. + // We record the error but keep going, to give a complete marshaling. + if errreq == nil { + errreq = err + } + continue + } + if err == ErrNil { + err = errRepeatedHasNil + } + return b, err + } + } + + return b, errreq + } +} + +func makeCustomPtrMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + if ptr.isNil() { + return 0 + } + m := ptr.asPointerTo(reflect.PtrTo(u.typ)).Elem().Interface().(custom) + siz := m.Size() + return tagsize + SizeVarint(uint64(siz)) + siz + }, func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + if ptr.isNil() { + return b, nil + } + m := ptr.asPointerTo(reflect.PtrTo(u.typ)).Elem().Interface().(custom) + siz := m.Size() + buf, err := m.Marshal() + if err != nil { + return nil, err + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(siz)) + b = append(b, buf...) + return b, nil + } +} + +func makeCustomMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + m := ptr.asPointerTo(u.typ).Interface().(custom) + siz := m.Size() + return tagsize + SizeVarint(uint64(siz)) + siz + }, func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + m := ptr.asPointerTo(u.typ).Interface().(custom) + siz := m.Size() + buf, err := m.Marshal() + if err != nil { + return nil, err + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(siz)) + b = append(b, buf...) + return b, nil + } +} + +func makeTimeMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + t := ptr.asPointerTo(u.typ).Interface().(*time.Time) + ts, err := timestampProto(*t) + if err != nil { + return 0 + } + siz := Size(ts) + return tagsize + SizeVarint(uint64(siz)) + siz + }, func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + t := ptr.asPointerTo(u.typ).Interface().(*time.Time) + ts, err := timestampProto(*t) + if err != nil { + return nil, err + } + buf, err := Marshal(ts) + if err != nil { + return nil, err + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(buf))) + b = append(b, buf...) + return b, nil + } +} + +func makeTimePtrMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + if ptr.isNil() { + return 0 + } + t := ptr.asPointerTo(reflect.PtrTo(u.typ)).Elem().Interface().(*time.Time) + ts, err := timestampProto(*t) + if err != nil { + return 0 + } + siz := Size(ts) + return tagsize + SizeVarint(uint64(siz)) + siz + }, func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + if ptr.isNil() { + return b, nil + } + t := ptr.asPointerTo(reflect.PtrTo(u.typ)).Elem().Interface().(*time.Time) + ts, err := timestampProto(*t) + if err != nil { + return nil, err + } + buf, err := Marshal(ts) + if err != nil { + return nil, err + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(buf))) + b = append(b, buf...) + return b, nil + } +} + +func makeTimeSliceMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + s := ptr.getSlice(u.typ) + n := 0 + for i := 0; i < s.Len(); i++ { + elem := s.Index(i) + t := elem.Interface().(time.Time) + ts, err := timestampProto(t) + if err != nil { + return 0 + } + siz := Size(ts) + n += siz + SizeVarint(uint64(siz)) + tagsize + } + return n + }, + func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + s := ptr.getSlice(u.typ) + for i := 0; i < s.Len(); i++ { + elem := s.Index(i) + t := elem.Interface().(time.Time) + ts, err := timestampProto(t) + if err != nil { + return nil, err + } + siz := Size(ts) + buf, err := Marshal(ts) + if err != nil { + return nil, err + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(siz)) + b = append(b, buf...) + } + + return b, nil + } +} + +func makeTimePtrSliceMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + s := ptr.getSlice(reflect.PtrTo(u.typ)) + n := 0 + for i := 0; i < s.Len(); i++ { + elem := s.Index(i) + t := elem.Interface().(*time.Time) + ts, err := timestampProto(*t) + if err != nil { + return 0 + } + siz := Size(ts) + n += siz + SizeVarint(uint64(siz)) + tagsize + } + return n + }, + func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + s := ptr.getSlice(reflect.PtrTo(u.typ)) + for i := 0; i < s.Len(); i++ { + elem := s.Index(i) + t := elem.Interface().(*time.Time) + ts, err := timestampProto(*t) + if err != nil { + return nil, err + } + siz := Size(ts) + buf, err := Marshal(ts) + if err != nil { + return nil, err + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(siz)) + b = append(b, buf...) + } + + return b, nil + } +} + +func makeDurationMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + d := ptr.asPointerTo(u.typ).Interface().(*time.Duration) + dur := durationProto(*d) + siz := Size(dur) + return tagsize + SizeVarint(uint64(siz)) + siz + }, func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + d := ptr.asPointerTo(u.typ).Interface().(*time.Duration) + dur := durationProto(*d) + buf, err := Marshal(dur) + if err != nil { + return nil, err + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(buf))) + b = append(b, buf...) + return b, nil + } +} + +func makeDurationPtrMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + if ptr.isNil() { + return 0 + } + d := ptr.asPointerTo(reflect.PtrTo(u.typ)).Elem().Interface().(*time.Duration) + dur := durationProto(*d) + siz := Size(dur) + return tagsize + SizeVarint(uint64(siz)) + siz + }, func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + if ptr.isNil() { + return b, nil + } + d := ptr.asPointerTo(reflect.PtrTo(u.typ)).Elem().Interface().(*time.Duration) + dur := durationProto(*d) + buf, err := Marshal(dur) + if err != nil { + return nil, err + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(len(buf))) + b = append(b, buf...) + return b, nil + } +} + +func makeDurationSliceMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + s := ptr.getSlice(u.typ) + n := 0 + for i := 0; i < s.Len(); i++ { + elem := s.Index(i) + d := elem.Interface().(time.Duration) + dur := durationProto(d) + siz := Size(dur) + n += siz + SizeVarint(uint64(siz)) + tagsize + } + return n + }, + func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + s := ptr.getSlice(u.typ) + for i := 0; i < s.Len(); i++ { + elem := s.Index(i) + d := elem.Interface().(time.Duration) + dur := durationProto(d) + siz := Size(dur) + buf, err := Marshal(dur) + if err != nil { + return nil, err + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(siz)) + b = append(b, buf...) + } + + return b, nil + } +} + +func makeDurationPtrSliceMarshaler(u *marshalInfo) (sizer, marshaler) { + return func(ptr pointer, tagsize int) int { + s := ptr.getSlice(reflect.PtrTo(u.typ)) + n := 0 + for i := 0; i < s.Len(); i++ { + elem := s.Index(i) + d := elem.Interface().(*time.Duration) + dur := durationProto(*d) + siz := Size(dur) + n += siz + SizeVarint(uint64(siz)) + tagsize + } + return n + }, + func(b []byte, ptr pointer, wiretag uint64, deterministic bool) ([]byte, error) { + s := ptr.getSlice(reflect.PtrTo(u.typ)) + for i := 0; i < s.Len(); i++ { + elem := s.Index(i) + d := elem.Interface().(*time.Duration) + dur := durationProto(*d) + siz := Size(dur) + buf, err := Marshal(dur) + if err != nil { + return nil, err + } + b = appendVarint(b, wiretag) + b = appendVarint(b, uint64(siz)) + b = append(b, buf...) + } + + return b, nil + } +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/table_merge.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/table_merge.go new file mode 100644 index 000000000000..f520106e09f5 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/table_merge.go @@ -0,0 +1,657 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2016 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "fmt" + "reflect" + "strings" + "sync" + "sync/atomic" +) + +// Merge merges the src message into dst. +// This assumes that dst and src of the same type and are non-nil. +func (a *InternalMessageInfo) Merge(dst, src Message) { + mi := atomicLoadMergeInfo(&a.merge) + if mi == nil { + mi = getMergeInfo(reflect.TypeOf(dst).Elem()) + atomicStoreMergeInfo(&a.merge, mi) + } + mi.merge(toPointer(&dst), toPointer(&src)) +} + +type mergeInfo struct { + typ reflect.Type + + initialized int32 // 0: only typ is valid, 1: everything is valid + lock sync.Mutex + + fields []mergeFieldInfo + unrecognized field // Offset of XXX_unrecognized +} + +type mergeFieldInfo struct { + field field // Offset of field, guaranteed to be valid + + // isPointer reports whether the value in the field is a pointer. + // This is true for the following situations: + // * Pointer to struct + // * Pointer to basic type (proto2 only) + // * Slice (first value in slice header is a pointer) + // * String (first value in string header is a pointer) + isPointer bool + + // basicWidth reports the width of the field assuming that it is directly + // embedded in the struct (as is the case for basic types in proto3). + // The possible values are: + // 0: invalid + // 1: bool + // 4: int32, uint32, float32 + // 8: int64, uint64, float64 + basicWidth int + + // Where dst and src are pointers to the types being merged. + merge func(dst, src pointer) +} + +var ( + mergeInfoMap = map[reflect.Type]*mergeInfo{} + mergeInfoLock sync.Mutex +) + +func getMergeInfo(t reflect.Type) *mergeInfo { + mergeInfoLock.Lock() + defer mergeInfoLock.Unlock() + mi := mergeInfoMap[t] + if mi == nil { + mi = &mergeInfo{typ: t} + mergeInfoMap[t] = mi + } + return mi +} + +// merge merges src into dst assuming they are both of type *mi.typ. +func (mi *mergeInfo) merge(dst, src pointer) { + if dst.isNil() { + panic("proto: nil destination") + } + if src.isNil() { + return // Nothing to do. + } + + if atomic.LoadInt32(&mi.initialized) == 0 { + mi.computeMergeInfo() + } + + for _, fi := range mi.fields { + sfp := src.offset(fi.field) + + // As an optimization, we can avoid the merge function call cost + // if we know for sure that the source will have no effect + // by checking if it is the zero value. + if unsafeAllowed { + if fi.isPointer && sfp.getPointer().isNil() { // Could be slice or string + continue + } + if fi.basicWidth > 0 { + switch { + case fi.basicWidth == 1 && !*sfp.toBool(): + continue + case fi.basicWidth == 4 && *sfp.toUint32() == 0: + continue + case fi.basicWidth == 8 && *sfp.toUint64() == 0: + continue + } + } + } + + dfp := dst.offset(fi.field) + fi.merge(dfp, sfp) + } + + // TODO: Make this faster? + out := dst.asPointerTo(mi.typ).Elem() + in := src.asPointerTo(mi.typ).Elem() + if emIn, err := extendable(in.Addr().Interface()); err == nil { + emOut, _ := extendable(out.Addr().Interface()) + mIn, muIn := emIn.extensionsRead() + if mIn != nil { + mOut := emOut.extensionsWrite() + muIn.Lock() + mergeExtension(mOut, mIn) + muIn.Unlock() + } + } + + if mi.unrecognized.IsValid() { + if b := *src.offset(mi.unrecognized).toBytes(); len(b) > 0 { + *dst.offset(mi.unrecognized).toBytes() = append([]byte(nil), b...) + } + } +} + +func (mi *mergeInfo) computeMergeInfo() { + mi.lock.Lock() + defer mi.lock.Unlock() + if mi.initialized != 0 { + return + } + t := mi.typ + n := t.NumField() + + props := GetProperties(t) + for i := 0; i < n; i++ { + f := t.Field(i) + if strings.HasPrefix(f.Name, "XXX_") { + continue + } + + mfi := mergeFieldInfo{field: toField(&f)} + tf := f.Type + + // As an optimization, we can avoid the merge function call cost + // if we know for sure that the source will have no effect + // by checking if it is the zero value. + if unsafeAllowed { + switch tf.Kind() { + case reflect.Ptr, reflect.Slice, reflect.String: + // As a special case, we assume slices and strings are pointers + // since we know that the first field in the SliceSlice or + // StringHeader is a data pointer. + mfi.isPointer = true + case reflect.Bool: + mfi.basicWidth = 1 + case reflect.Int32, reflect.Uint32, reflect.Float32: + mfi.basicWidth = 4 + case reflect.Int64, reflect.Uint64, reflect.Float64: + mfi.basicWidth = 8 + } + } + + // Unwrap tf to get at its most basic type. + var isPointer, isSlice bool + if tf.Kind() == reflect.Slice && tf.Elem().Kind() != reflect.Uint8 { + isSlice = true + tf = tf.Elem() + } + if tf.Kind() == reflect.Ptr { + isPointer = true + tf = tf.Elem() + } + if isPointer && isSlice && tf.Kind() != reflect.Struct { + panic("both pointer and slice for basic type in " + tf.Name()) + } + + switch tf.Kind() { + case reflect.Int32: + switch { + case isSlice: // E.g., []int32 + mfi.merge = func(dst, src pointer) { + // NOTE: toInt32Slice is not defined (see pointer_reflect.go). + /* + sfsp := src.toInt32Slice() + if *sfsp != nil { + dfsp := dst.toInt32Slice() + *dfsp = append(*dfsp, *sfsp...) + if *dfsp == nil { + *dfsp = []int64{} + } + } + */ + sfs := src.getInt32Slice() + if sfs != nil { + dfs := dst.getInt32Slice() + dfs = append(dfs, sfs...) + if dfs == nil { + dfs = []int32{} + } + dst.setInt32Slice(dfs) + } + } + case isPointer: // E.g., *int32 + mfi.merge = func(dst, src pointer) { + // NOTE: toInt32Ptr is not defined (see pointer_reflect.go). + /* + sfpp := src.toInt32Ptr() + if *sfpp != nil { + dfpp := dst.toInt32Ptr() + if *dfpp == nil { + *dfpp = Int32(**sfpp) + } else { + **dfpp = **sfpp + } + } + */ + sfp := src.getInt32Ptr() + if sfp != nil { + dfp := dst.getInt32Ptr() + if dfp == nil { + dst.setInt32Ptr(*sfp) + } else { + *dfp = *sfp + } + } + } + default: // E.g., int32 + mfi.merge = func(dst, src pointer) { + if v := *src.toInt32(); v != 0 { + *dst.toInt32() = v + } + } + } + case reflect.Int64: + switch { + case isSlice: // E.g., []int64 + mfi.merge = func(dst, src pointer) { + sfsp := src.toInt64Slice() + if *sfsp != nil { + dfsp := dst.toInt64Slice() + *dfsp = append(*dfsp, *sfsp...) + if *dfsp == nil { + *dfsp = []int64{} + } + } + } + case isPointer: // E.g., *int64 + mfi.merge = func(dst, src pointer) { + sfpp := src.toInt64Ptr() + if *sfpp != nil { + dfpp := dst.toInt64Ptr() + if *dfpp == nil { + *dfpp = Int64(**sfpp) + } else { + **dfpp = **sfpp + } + } + } + default: // E.g., int64 + mfi.merge = func(dst, src pointer) { + if v := *src.toInt64(); v != 0 { + *dst.toInt64() = v + } + } + } + case reflect.Uint32: + switch { + case isSlice: // E.g., []uint32 + mfi.merge = func(dst, src pointer) { + sfsp := src.toUint32Slice() + if *sfsp != nil { + dfsp := dst.toUint32Slice() + *dfsp = append(*dfsp, *sfsp...) + if *dfsp == nil { + *dfsp = []uint32{} + } + } + } + case isPointer: // E.g., *uint32 + mfi.merge = func(dst, src pointer) { + sfpp := src.toUint32Ptr() + if *sfpp != nil { + dfpp := dst.toUint32Ptr() + if *dfpp == nil { + *dfpp = Uint32(**sfpp) + } else { + **dfpp = **sfpp + } + } + } + default: // E.g., uint32 + mfi.merge = func(dst, src pointer) { + if v := *src.toUint32(); v != 0 { + *dst.toUint32() = v + } + } + } + case reflect.Uint64: + switch { + case isSlice: // E.g., []uint64 + mfi.merge = func(dst, src pointer) { + sfsp := src.toUint64Slice() + if *sfsp != nil { + dfsp := dst.toUint64Slice() + *dfsp = append(*dfsp, *sfsp...) + if *dfsp == nil { + *dfsp = []uint64{} + } + } + } + case isPointer: // E.g., *uint64 + mfi.merge = func(dst, src pointer) { + sfpp := src.toUint64Ptr() + if *sfpp != nil { + dfpp := dst.toUint64Ptr() + if *dfpp == nil { + *dfpp = Uint64(**sfpp) + } else { + **dfpp = **sfpp + } + } + } + default: // E.g., uint64 + mfi.merge = func(dst, src pointer) { + if v := *src.toUint64(); v != 0 { + *dst.toUint64() = v + } + } + } + case reflect.Float32: + switch { + case isSlice: // E.g., []float32 + mfi.merge = func(dst, src pointer) { + sfsp := src.toFloat32Slice() + if *sfsp != nil { + dfsp := dst.toFloat32Slice() + *dfsp = append(*dfsp, *sfsp...) + if *dfsp == nil { + *dfsp = []float32{} + } + } + } + case isPointer: // E.g., *float32 + mfi.merge = func(dst, src pointer) { + sfpp := src.toFloat32Ptr() + if *sfpp != nil { + dfpp := dst.toFloat32Ptr() + if *dfpp == nil { + *dfpp = Float32(**sfpp) + } else { + **dfpp = **sfpp + } + } + } + default: // E.g., float32 + mfi.merge = func(dst, src pointer) { + if v := *src.toFloat32(); v != 0 { + *dst.toFloat32() = v + } + } + } + case reflect.Float64: + switch { + case isSlice: // E.g., []float64 + mfi.merge = func(dst, src pointer) { + sfsp := src.toFloat64Slice() + if *sfsp != nil { + dfsp := dst.toFloat64Slice() + *dfsp = append(*dfsp, *sfsp...) + if *dfsp == nil { + *dfsp = []float64{} + } + } + } + case isPointer: // E.g., *float64 + mfi.merge = func(dst, src pointer) { + sfpp := src.toFloat64Ptr() + if *sfpp != nil { + dfpp := dst.toFloat64Ptr() + if *dfpp == nil { + *dfpp = Float64(**sfpp) + } else { + **dfpp = **sfpp + } + } + } + default: // E.g., float64 + mfi.merge = func(dst, src pointer) { + if v := *src.toFloat64(); v != 0 { + *dst.toFloat64() = v + } + } + } + case reflect.Bool: + switch { + case isSlice: // E.g., []bool + mfi.merge = func(dst, src pointer) { + sfsp := src.toBoolSlice() + if *sfsp != nil { + dfsp := dst.toBoolSlice() + *dfsp = append(*dfsp, *sfsp...) + if *dfsp == nil { + *dfsp = []bool{} + } + } + } + case isPointer: // E.g., *bool + mfi.merge = func(dst, src pointer) { + sfpp := src.toBoolPtr() + if *sfpp != nil { + dfpp := dst.toBoolPtr() + if *dfpp == nil { + *dfpp = Bool(**sfpp) + } else { + **dfpp = **sfpp + } + } + } + default: // E.g., bool + mfi.merge = func(dst, src pointer) { + if v := *src.toBool(); v { + *dst.toBool() = v + } + } + } + case reflect.String: + switch { + case isSlice: // E.g., []string + mfi.merge = func(dst, src pointer) { + sfsp := src.toStringSlice() + if *sfsp != nil { + dfsp := dst.toStringSlice() + *dfsp = append(*dfsp, *sfsp...) + if *dfsp == nil { + *dfsp = []string{} + } + } + } + case isPointer: // E.g., *string + mfi.merge = func(dst, src pointer) { + sfpp := src.toStringPtr() + if *sfpp != nil { + dfpp := dst.toStringPtr() + if *dfpp == nil { + *dfpp = String(**sfpp) + } else { + **dfpp = **sfpp + } + } + } + default: // E.g., string + mfi.merge = func(dst, src pointer) { + if v := *src.toString(); v != "" { + *dst.toString() = v + } + } + } + case reflect.Slice: + isProto3 := props.Prop[i].proto3 + switch { + case isPointer: + panic("bad pointer in byte slice case in " + tf.Name()) + case tf.Elem().Kind() != reflect.Uint8: + panic("bad element kind in byte slice case in " + tf.Name()) + case isSlice: // E.g., [][]byte + mfi.merge = func(dst, src pointer) { + sbsp := src.toBytesSlice() + if *sbsp != nil { + dbsp := dst.toBytesSlice() + for _, sb := range *sbsp { + if sb == nil { + *dbsp = append(*dbsp, nil) + } else { + *dbsp = append(*dbsp, append([]byte{}, sb...)) + } + } + if *dbsp == nil { + *dbsp = [][]byte{} + } + } + } + default: // E.g., []byte + mfi.merge = func(dst, src pointer) { + sbp := src.toBytes() + if *sbp != nil { + dbp := dst.toBytes() + if !isProto3 || len(*sbp) > 0 { + *dbp = append([]byte{}, *sbp...) + } + } + } + } + case reflect.Struct: + switch { + case !isPointer: + mergeInfo := getMergeInfo(tf) + mfi.merge = func(dst, src pointer) { + mergeInfo.merge(dst, src) + } + case isSlice: // E.g., []*pb.T + mergeInfo := getMergeInfo(tf) + mfi.merge = func(dst, src pointer) { + sps := src.getPointerSlice() + if sps != nil { + dps := dst.getPointerSlice() + for _, sp := range sps { + var dp pointer + if !sp.isNil() { + dp = valToPointer(reflect.New(tf)) + mergeInfo.merge(dp, sp) + } + dps = append(dps, dp) + } + if dps == nil { + dps = []pointer{} + } + dst.setPointerSlice(dps) + } + } + default: // E.g., *pb.T + mergeInfo := getMergeInfo(tf) + mfi.merge = func(dst, src pointer) { + sp := src.getPointer() + if !sp.isNil() { + dp := dst.getPointer() + if dp.isNil() { + dp = valToPointer(reflect.New(tf)) + dst.setPointer(dp) + } + mergeInfo.merge(dp, sp) + } + } + } + case reflect.Map: + switch { + case isPointer || isSlice: + panic("bad pointer or slice in map case in " + tf.Name()) + default: // E.g., map[K]V + mfi.merge = func(dst, src pointer) { + sm := src.asPointerTo(tf).Elem() + if sm.Len() == 0 { + return + } + dm := dst.asPointerTo(tf).Elem() + if dm.IsNil() { + dm.Set(reflect.MakeMap(tf)) + } + + switch tf.Elem().Kind() { + case reflect.Ptr: // Proto struct (e.g., *T) + for _, key := range sm.MapKeys() { + val := sm.MapIndex(key) + val = reflect.ValueOf(Clone(val.Interface().(Message))) + dm.SetMapIndex(key, val) + } + case reflect.Slice: // E.g. Bytes type (e.g., []byte) + for _, key := range sm.MapKeys() { + val := sm.MapIndex(key) + val = reflect.ValueOf(append([]byte{}, val.Bytes()...)) + dm.SetMapIndex(key, val) + } + default: // Basic type (e.g., string) + for _, key := range sm.MapKeys() { + val := sm.MapIndex(key) + dm.SetMapIndex(key, val) + } + } + } + } + case reflect.Interface: + // Must be oneof field. + switch { + case isPointer || isSlice: + panic("bad pointer or slice in interface case in " + tf.Name()) + default: // E.g., interface{} + // TODO: Make this faster? + mfi.merge = func(dst, src pointer) { + su := src.asPointerTo(tf).Elem() + if !su.IsNil() { + du := dst.asPointerTo(tf).Elem() + typ := su.Elem().Type() + if du.IsNil() || du.Elem().Type() != typ { + du.Set(reflect.New(typ.Elem())) // Initialize interface if empty + } + sv := su.Elem().Elem().Field(0) + if sv.Kind() == reflect.Ptr && sv.IsNil() { + return + } + dv := du.Elem().Elem().Field(0) + if dv.Kind() == reflect.Ptr && dv.IsNil() { + dv.Set(reflect.New(sv.Type().Elem())) // Initialize proto message if empty + } + switch sv.Type().Kind() { + case reflect.Ptr: // Proto struct (e.g., *T) + Merge(dv.Interface().(Message), sv.Interface().(Message)) + case reflect.Slice: // E.g. Bytes type (e.g., []byte) + dv.Set(reflect.ValueOf(append([]byte{}, sv.Bytes()...))) + default: // Basic type (e.g., string) + dv.Set(sv) + } + } + } + } + default: + panic(fmt.Sprintf("merger not found for type:%s", tf)) + } + mi.fields = append(mi.fields, mfi) + } + + mi.unrecognized = invalidField + if f, ok := t.FieldByName("XXX_unrecognized"); ok { + if f.Type != reflect.TypeOf([]byte{}) { + panic("expected XXX_unrecognized to be of type []byte") + } + mi.unrecognized = toField(&f) + } + + atomic.StoreInt32(&mi.initialized, 1) +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/table_unmarshal.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/table_unmarshal.go new file mode 100644 index 000000000000..910e2dd6ad31 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/table_unmarshal.go @@ -0,0 +1,2048 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2016 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "errors" + "fmt" + "io" + "math" + "reflect" + "strconv" + "strings" + "sync" + "sync/atomic" + "unicode/utf8" +) + +// Unmarshal is the entry point from the generated .pb.go files. +// This function is not intended to be used by non-generated code. +// This function is not subject to any compatibility guarantee. +// msg contains a pointer to a protocol buffer struct. +// b is the data to be unmarshaled into the protocol buffer. +// a is a pointer to a place to store cached unmarshal information. +func (a *InternalMessageInfo) Unmarshal(msg Message, b []byte) error { + // Load the unmarshal information for this message type. + // The atomic load ensures memory consistency. + u := atomicLoadUnmarshalInfo(&a.unmarshal) + if u == nil { + // Slow path: find unmarshal info for msg, update a with it. + u = getUnmarshalInfo(reflect.TypeOf(msg).Elem()) + atomicStoreUnmarshalInfo(&a.unmarshal, u) + } + // Then do the unmarshaling. + err := u.unmarshal(toPointer(&msg), b) + return err +} + +type unmarshalInfo struct { + typ reflect.Type // type of the protobuf struct + + // 0 = only typ field is initialized + // 1 = completely initialized + initialized int32 + lock sync.Mutex // prevents double initialization + dense []unmarshalFieldInfo // fields indexed by tag # + sparse map[uint64]unmarshalFieldInfo // fields indexed by tag # + reqFields []string // names of required fields + reqMask uint64 // 1< 0 { + // Read tag and wire type. + // Special case 1 and 2 byte varints. + var x uint64 + if b[0] < 128 { + x = uint64(b[0]) + b = b[1:] + } else if len(b) >= 2 && b[1] < 128 { + x = uint64(b[0]&0x7f) + uint64(b[1])<<7 + b = b[2:] + } else { + var n int + x, n = decodeVarint(b) + if n == 0 { + return io.ErrUnexpectedEOF + } + b = b[n:] + } + tag := x >> 3 + wire := int(x) & 7 + + // Dispatch on the tag to one of the unmarshal* functions below. + var f unmarshalFieldInfo + if tag < uint64(len(u.dense)) { + f = u.dense[tag] + } else { + f = u.sparse[tag] + } + if fn := f.unmarshal; fn != nil { + var err error + b, err = fn(b, m.offset(f.field), wire) + if err == nil { + reqMask |= f.reqMask + continue + } + if r, ok := err.(*RequiredNotSetError); ok { + // Remember this error, but keep parsing. We need to produce + // a full parse even if a required field is missing. + rnse = r + reqMask |= f.reqMask + continue + } + if err != errInternalBadWireType { + return err + } + // Fragments with bad wire type are treated as unknown fields. + } + + // Unknown tag. + if !u.unrecognized.IsValid() { + // Don't keep unrecognized data; just skip it. + var err error + b, err = skipField(b, wire) + if err != nil { + return err + } + continue + } + // Keep unrecognized data around. + // maybe in extensions, maybe in the unrecognized field. + z := m.offset(u.unrecognized).toBytes() + var emap map[int32]Extension + var e Extension + for _, r := range u.extensionRanges { + if uint64(r.Start) <= tag && tag <= uint64(r.End) { + if u.extensions.IsValid() { + mp := m.offset(u.extensions).toExtensions() + emap = mp.extensionsWrite() + e = emap[int32(tag)] + z = &e.enc + break + } + if u.oldExtensions.IsValid() { + p := m.offset(u.oldExtensions).toOldExtensions() + emap = *p + if emap == nil { + emap = map[int32]Extension{} + *p = emap + } + e = emap[int32(tag)] + z = &e.enc + break + } + if u.bytesExtensions.IsValid() { + z = m.offset(u.bytesExtensions).toBytes() + break + } + panic("no extensions field available") + } + } + // Use wire type to skip data. + var err error + b0 := b + b, err = skipField(b, wire) + if err != nil { + return err + } + *z = encodeVarint(*z, tag<<3|uint64(wire)) + *z = append(*z, b0[:len(b0)-len(b)]...) + + if emap != nil { + emap[int32(tag)] = e + } + } + if rnse != nil { + // A required field of a submessage/group is missing. Return that error. + return rnse + } + if reqMask != u.reqMask { + // A required field of this message is missing. + for _, n := range u.reqFields { + if reqMask&1 == 0 { + return &RequiredNotSetError{n} + } + reqMask >>= 1 + } + } + return nil +} + +// computeUnmarshalInfo fills in u with information for use +// in unmarshaling protocol buffers of type u.typ. +func (u *unmarshalInfo) computeUnmarshalInfo() { + u.lock.Lock() + defer u.lock.Unlock() + if u.initialized != 0 { + return + } + t := u.typ + n := t.NumField() + + // Set up the "not found" value for the unrecognized byte buffer. + // This is the default for proto3. + u.unrecognized = invalidField + u.extensions = invalidField + u.oldExtensions = invalidField + u.bytesExtensions = invalidField + + // List of the generated type and offset for each oneof field. + type oneofField struct { + ityp reflect.Type // interface type of oneof field + field field // offset in containing message + } + var oneofFields []oneofField + + for i := 0; i < n; i++ { + f := t.Field(i) + if f.Name == "XXX_unrecognized" { + // The byte slice used to hold unrecognized input is special. + if f.Type != reflect.TypeOf(([]byte)(nil)) { + panic("bad type for XXX_unrecognized field: " + f.Type.Name()) + } + u.unrecognized = toField(&f) + continue + } + if f.Name == "XXX_InternalExtensions" { + // Ditto here. + if f.Type != reflect.TypeOf(XXX_InternalExtensions{}) { + panic("bad type for XXX_InternalExtensions field: " + f.Type.Name()) + } + u.extensions = toField(&f) + if f.Tag.Get("protobuf_messageset") == "1" { + u.isMessageSet = true + } + continue + } + if f.Name == "XXX_extensions" { + // An older form of the extensions field. + if f.Type == reflect.TypeOf((map[int32]Extension)(nil)) { + u.oldExtensions = toField(&f) + continue + } else if f.Type == reflect.TypeOf(([]byte)(nil)) { + u.bytesExtensions = toField(&f) + continue + } + panic("bad type for XXX_extensions field: " + f.Type.Name()) + } + if f.Name == "XXX_NoUnkeyedLiteral" || f.Name == "XXX_sizecache" { + continue + } + + oneof := f.Tag.Get("protobuf_oneof") + if oneof != "" { + oneofFields = append(oneofFields, oneofField{f.Type, toField(&f)}) + // The rest of oneof processing happens below. + continue + } + + tags := f.Tag.Get("protobuf") + tagArray := strings.Split(tags, ",") + if len(tagArray) < 2 { + panic("protobuf tag not enough fields in " + t.Name() + "." + f.Name + ": " + tags) + } + tag, err := strconv.Atoi(tagArray[1]) + if err != nil { + panic("protobuf tag field not an integer: " + tagArray[1]) + } + + name := "" + for _, tag := range tagArray[3:] { + if strings.HasPrefix(tag, "name=") { + name = tag[5:] + } + } + + // Extract unmarshaling function from the field (its type and tags). + unmarshal := fieldUnmarshaler(&f) + + // Required field? + var reqMask uint64 + if tagArray[2] == "req" { + bit := len(u.reqFields) + u.reqFields = append(u.reqFields, name) + reqMask = uint64(1) << uint(bit) + // TODO: if we have more than 64 required fields, we end up + // not verifying that all required fields are present. + // Fix this, perhaps using a count of required fields? + } + + // Store the info in the correct slot in the message. + u.setTag(tag, toField(&f), unmarshal, reqMask) + } + + // Find any types associated with oneof fields. + // TODO: XXX_OneofFuncs returns more info than we need. Get rid of some of it? + fn := reflect.Zero(reflect.PtrTo(t)).MethodByName("XXX_OneofFuncs") + // gogo: len(oneofFields) > 0 is needed for embedded oneof messages, without a marshaler and unmarshaler + if fn.IsValid() && len(oneofFields) > 0 { + res := fn.Call(nil)[3] // last return value from XXX_OneofFuncs: []interface{} + for i := res.Len() - 1; i >= 0; i-- { + v := res.Index(i) // interface{} + tptr := reflect.ValueOf(v.Interface()).Type() // *Msg_X + typ := tptr.Elem() // Msg_X + + f := typ.Field(0) // oneof implementers have one field + baseUnmarshal := fieldUnmarshaler(&f) + tagstr := strings.Split(f.Tag.Get("protobuf"), ",")[1] + tag, err := strconv.Atoi(tagstr) + if err != nil { + panic("protobuf tag field not an integer: " + tagstr) + } + + // Find the oneof field that this struct implements. + // Might take O(n^2) to process all of the oneofs, but who cares. + for _, of := range oneofFields { + if tptr.Implements(of.ityp) { + // We have found the corresponding interface for this struct. + // That lets us know where this struct should be stored + // when we encounter it during unmarshaling. + unmarshal := makeUnmarshalOneof(typ, of.ityp, baseUnmarshal) + u.setTag(tag, of.field, unmarshal, 0) + } + } + } + } + + // Get extension ranges, if any. + fn = reflect.Zero(reflect.PtrTo(t)).MethodByName("ExtensionRangeArray") + if fn.IsValid() { + if !u.extensions.IsValid() && !u.oldExtensions.IsValid() && !u.bytesExtensions.IsValid() { + panic("a message with extensions, but no extensions field in " + t.Name()) + } + u.extensionRanges = fn.Call(nil)[0].Interface().([]ExtensionRange) + } + + // Explicitly disallow tag 0. This will ensure we flag an error + // when decoding a buffer of all zeros. Without this code, we + // would decode and skip an all-zero buffer of even length. + // [0 0] is [tag=0/wiretype=varint varint-encoded-0]. + u.setTag(0, zeroField, func(b []byte, f pointer, w int) ([]byte, error) { + return nil, fmt.Errorf("proto: %s: illegal tag 0 (wire type %d)", t, w) + }, 0) + + // Set mask for required field check. + u.reqMask = uint64(1)<= 0 && (tag < 16 || tag < 2*n) { // TODO: what are the right numbers here? + for len(u.dense) <= tag { + u.dense = append(u.dense, unmarshalFieldInfo{}) + } + u.dense[tag] = i + return + } + if u.sparse == nil { + u.sparse = map[uint64]unmarshalFieldInfo{} + } + u.sparse[uint64(tag)] = i +} + +// fieldUnmarshaler returns an unmarshaler for the given field. +func fieldUnmarshaler(f *reflect.StructField) unmarshaler { + if f.Type.Kind() == reflect.Map { + return makeUnmarshalMap(f) + } + return typeUnmarshaler(f.Type, f.Tag.Get("protobuf")) +} + +// typeUnmarshaler returns an unmarshaler for the given field type / field tag pair. +func typeUnmarshaler(t reflect.Type, tags string) unmarshaler { + tagArray := strings.Split(tags, ",") + encoding := tagArray[0] + name := "unknown" + ctype := false + isTime := false + isDuration := false + for _, tag := range tagArray[3:] { + if strings.HasPrefix(tag, "name=") { + name = tag[5:] + } + if strings.HasPrefix(tag, "customtype=") { + ctype = true + } + if tag == "stdtime" { + isTime = true + } + if tag == "stdduration" { + isDuration = true + } + } + + // Figure out packaging (pointer, slice, or both) + slice := false + pointer := false + if t.Kind() == reflect.Slice && t.Elem().Kind() != reflect.Uint8 { + slice = true + t = t.Elem() + } + if t.Kind() == reflect.Ptr { + pointer = true + t = t.Elem() + } + + if ctype { + if reflect.PtrTo(t).Implements(customType) { + if slice { + return makeUnmarshalCustomSlice(getUnmarshalInfo(t), name) + } + if pointer { + return makeUnmarshalCustomPtr(getUnmarshalInfo(t), name) + } + return makeUnmarshalCustom(getUnmarshalInfo(t), name) + } else { + panic(fmt.Sprintf("custom type: type: %v, does not implement the proto.custom interface", t)) + } + } + + if isTime { + if pointer { + if slice { + return makeUnmarshalTimePtrSlice(getUnmarshalInfo(t), name) + } + return makeUnmarshalTimePtr(getUnmarshalInfo(t), name) + } + if slice { + return makeUnmarshalTimeSlice(getUnmarshalInfo(t), name) + } + return makeUnmarshalTime(getUnmarshalInfo(t), name) + } + + if isDuration { + if pointer { + if slice { + return makeUnmarshalDurationPtrSlice(getUnmarshalInfo(t), name) + } + return makeUnmarshalDurationPtr(getUnmarshalInfo(t), name) + } + if slice { + return makeUnmarshalDurationSlice(getUnmarshalInfo(t), name) + } + return makeUnmarshalDuration(getUnmarshalInfo(t), name) + } + + // We'll never have both pointer and slice for basic types. + if pointer && slice && t.Kind() != reflect.Struct { + panic("both pointer and slice for basic type in " + t.Name()) + } + + switch t.Kind() { + case reflect.Bool: + if pointer { + return unmarshalBoolPtr + } + if slice { + return unmarshalBoolSlice + } + return unmarshalBoolValue + case reflect.Int32: + switch encoding { + case "fixed32": + if pointer { + return unmarshalFixedS32Ptr + } + if slice { + return unmarshalFixedS32Slice + } + return unmarshalFixedS32Value + case "varint": + // this could be int32 or enum + if pointer { + return unmarshalInt32Ptr + } + if slice { + return unmarshalInt32Slice + } + return unmarshalInt32Value + case "zigzag32": + if pointer { + return unmarshalSint32Ptr + } + if slice { + return unmarshalSint32Slice + } + return unmarshalSint32Value + } + case reflect.Int64: + switch encoding { + case "fixed64": + if pointer { + return unmarshalFixedS64Ptr + } + if slice { + return unmarshalFixedS64Slice + } + return unmarshalFixedS64Value + case "varint": + if pointer { + return unmarshalInt64Ptr + } + if slice { + return unmarshalInt64Slice + } + return unmarshalInt64Value + case "zigzag64": + if pointer { + return unmarshalSint64Ptr + } + if slice { + return unmarshalSint64Slice + } + return unmarshalSint64Value + } + case reflect.Uint32: + switch encoding { + case "fixed32": + if pointer { + return unmarshalFixed32Ptr + } + if slice { + return unmarshalFixed32Slice + } + return unmarshalFixed32Value + case "varint": + if pointer { + return unmarshalUint32Ptr + } + if slice { + return unmarshalUint32Slice + } + return unmarshalUint32Value + } + case reflect.Uint64: + switch encoding { + case "fixed64": + if pointer { + return unmarshalFixed64Ptr + } + if slice { + return unmarshalFixed64Slice + } + return unmarshalFixed64Value + case "varint": + if pointer { + return unmarshalUint64Ptr + } + if slice { + return unmarshalUint64Slice + } + return unmarshalUint64Value + } + case reflect.Float32: + if pointer { + return unmarshalFloat32Ptr + } + if slice { + return unmarshalFloat32Slice + } + return unmarshalFloat32Value + case reflect.Float64: + if pointer { + return unmarshalFloat64Ptr + } + if slice { + return unmarshalFloat64Slice + } + return unmarshalFloat64Value + case reflect.Map: + panic("map type in typeUnmarshaler in " + t.Name()) + case reflect.Slice: + if pointer { + panic("bad pointer in slice case in " + t.Name()) + } + if slice { + return unmarshalBytesSlice + } + return unmarshalBytesValue + case reflect.String: + if pointer { + return unmarshalStringPtr + } + if slice { + return unmarshalStringSlice + } + return unmarshalStringValue + case reflect.Struct: + // message or group field + if !pointer { + switch encoding { + case "bytes": + if slice { + return makeUnmarshalMessageSlice(getUnmarshalInfo(t), name) + } + return makeUnmarshalMessage(getUnmarshalInfo(t), name) + } + } + switch encoding { + case "bytes": + if slice { + return makeUnmarshalMessageSlicePtr(getUnmarshalInfo(t), name) + } + return makeUnmarshalMessagePtr(getUnmarshalInfo(t), name) + case "group": + if slice { + return makeUnmarshalGroupSlicePtr(getUnmarshalInfo(t), name) + } + return makeUnmarshalGroupPtr(getUnmarshalInfo(t), name) + } + } + panic(fmt.Sprintf("unmarshaler not found type:%s encoding:%s", t, encoding)) +} + +// Below are all the unmarshalers for individual fields of various types. + +func unmarshalInt64Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int64(x) + *f.toInt64() = v + return b, nil +} + +func unmarshalInt64Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int64(x) + *f.toInt64Ptr() = &v + return b, nil +} + +func unmarshalInt64Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + x, n = decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int64(x) + s := f.toInt64Slice() + *s = append(*s, v) + } + return res, nil + } + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int64(x) + s := f.toInt64Slice() + *s = append(*s, v) + return b, nil +} + +func unmarshalSint64Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int64(x>>1) ^ int64(x)<<63>>63 + *f.toInt64() = v + return b, nil +} + +func unmarshalSint64Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int64(x>>1) ^ int64(x)<<63>>63 + *f.toInt64Ptr() = &v + return b, nil +} + +func unmarshalSint64Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + x, n = decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int64(x>>1) ^ int64(x)<<63>>63 + s := f.toInt64Slice() + *s = append(*s, v) + } + return res, nil + } + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int64(x>>1) ^ int64(x)<<63>>63 + s := f.toInt64Slice() + *s = append(*s, v) + return b, nil +} + +func unmarshalUint64Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := uint64(x) + *f.toUint64() = v + return b, nil +} + +func unmarshalUint64Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := uint64(x) + *f.toUint64Ptr() = &v + return b, nil +} + +func unmarshalUint64Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + x, n = decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := uint64(x) + s := f.toUint64Slice() + *s = append(*s, v) + } + return res, nil + } + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := uint64(x) + s := f.toUint64Slice() + *s = append(*s, v) + return b, nil +} + +func unmarshalInt32Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int32(x) + *f.toInt32() = v + return b, nil +} + +func unmarshalInt32Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int32(x) + f.setInt32Ptr(v) + return b, nil +} + +func unmarshalInt32Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + x, n = decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int32(x) + f.appendInt32Slice(v) + } + return res, nil + } + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int32(x) + f.appendInt32Slice(v) + return b, nil +} + +func unmarshalSint32Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int32(x>>1) ^ int32(x)<<31>>31 + *f.toInt32() = v + return b, nil +} + +func unmarshalSint32Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int32(x>>1) ^ int32(x)<<31>>31 + f.setInt32Ptr(v) + return b, nil +} + +func unmarshalSint32Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + x, n = decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int32(x>>1) ^ int32(x)<<31>>31 + f.appendInt32Slice(v) + } + return res, nil + } + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := int32(x>>1) ^ int32(x)<<31>>31 + f.appendInt32Slice(v) + return b, nil +} + +func unmarshalUint32Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := uint32(x) + *f.toUint32() = v + return b, nil +} + +func unmarshalUint32Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := uint32(x) + *f.toUint32Ptr() = &v + return b, nil +} + +func unmarshalUint32Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + x, n = decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := uint32(x) + s := f.toUint32Slice() + *s = append(*s, v) + } + return res, nil + } + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + v := uint32(x) + s := f.toUint32Slice() + *s = append(*s, v) + return b, nil +} + +func unmarshalFixed64Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed64 { + return b, errInternalBadWireType + } + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := uint64(b[0]) | uint64(b[1])<<8 | uint64(b[2])<<16 | uint64(b[3])<<24 | uint64(b[4])<<32 | uint64(b[5])<<40 | uint64(b[6])<<48 | uint64(b[7])<<56 + *f.toUint64() = v + return b[8:], nil +} + +func unmarshalFixed64Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed64 { + return b, errInternalBadWireType + } + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := uint64(b[0]) | uint64(b[1])<<8 | uint64(b[2])<<16 | uint64(b[3])<<24 | uint64(b[4])<<32 | uint64(b[5])<<40 | uint64(b[6])<<48 | uint64(b[7])<<56 + *f.toUint64Ptr() = &v + return b[8:], nil +} + +func unmarshalFixed64Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := uint64(b[0]) | uint64(b[1])<<8 | uint64(b[2])<<16 | uint64(b[3])<<24 | uint64(b[4])<<32 | uint64(b[5])<<40 | uint64(b[6])<<48 | uint64(b[7])<<56 + s := f.toUint64Slice() + *s = append(*s, v) + b = b[8:] + } + return res, nil + } + if w != WireFixed64 { + return b, errInternalBadWireType + } + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := uint64(b[0]) | uint64(b[1])<<8 | uint64(b[2])<<16 | uint64(b[3])<<24 | uint64(b[4])<<32 | uint64(b[5])<<40 | uint64(b[6])<<48 | uint64(b[7])<<56 + s := f.toUint64Slice() + *s = append(*s, v) + return b[8:], nil +} + +func unmarshalFixedS64Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed64 { + return b, errInternalBadWireType + } + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := int64(b[0]) | int64(b[1])<<8 | int64(b[2])<<16 | int64(b[3])<<24 | int64(b[4])<<32 | int64(b[5])<<40 | int64(b[6])<<48 | int64(b[7])<<56 + *f.toInt64() = v + return b[8:], nil +} + +func unmarshalFixedS64Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed64 { + return b, errInternalBadWireType + } + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := int64(b[0]) | int64(b[1])<<8 | int64(b[2])<<16 | int64(b[3])<<24 | int64(b[4])<<32 | int64(b[5])<<40 | int64(b[6])<<48 | int64(b[7])<<56 + *f.toInt64Ptr() = &v + return b[8:], nil +} + +func unmarshalFixedS64Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := int64(b[0]) | int64(b[1])<<8 | int64(b[2])<<16 | int64(b[3])<<24 | int64(b[4])<<32 | int64(b[5])<<40 | int64(b[6])<<48 | int64(b[7])<<56 + s := f.toInt64Slice() + *s = append(*s, v) + b = b[8:] + } + return res, nil + } + if w != WireFixed64 { + return b, errInternalBadWireType + } + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := int64(b[0]) | int64(b[1])<<8 | int64(b[2])<<16 | int64(b[3])<<24 | int64(b[4])<<32 | int64(b[5])<<40 | int64(b[6])<<48 | int64(b[7])<<56 + s := f.toInt64Slice() + *s = append(*s, v) + return b[8:], nil +} + +func unmarshalFixed32Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed32 { + return b, errInternalBadWireType + } + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := uint32(b[0]) | uint32(b[1])<<8 | uint32(b[2])<<16 | uint32(b[3])<<24 + *f.toUint32() = v + return b[4:], nil +} + +func unmarshalFixed32Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed32 { + return b, errInternalBadWireType + } + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := uint32(b[0]) | uint32(b[1])<<8 | uint32(b[2])<<16 | uint32(b[3])<<24 + *f.toUint32Ptr() = &v + return b[4:], nil +} + +func unmarshalFixed32Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := uint32(b[0]) | uint32(b[1])<<8 | uint32(b[2])<<16 | uint32(b[3])<<24 + s := f.toUint32Slice() + *s = append(*s, v) + b = b[4:] + } + return res, nil + } + if w != WireFixed32 { + return b, errInternalBadWireType + } + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := uint32(b[0]) | uint32(b[1])<<8 | uint32(b[2])<<16 | uint32(b[3])<<24 + s := f.toUint32Slice() + *s = append(*s, v) + return b[4:], nil +} + +func unmarshalFixedS32Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed32 { + return b, errInternalBadWireType + } + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := int32(b[0]) | int32(b[1])<<8 | int32(b[2])<<16 | int32(b[3])<<24 + *f.toInt32() = v + return b[4:], nil +} + +func unmarshalFixedS32Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed32 { + return b, errInternalBadWireType + } + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := int32(b[0]) | int32(b[1])<<8 | int32(b[2])<<16 | int32(b[3])<<24 + f.setInt32Ptr(v) + return b[4:], nil +} + +func unmarshalFixedS32Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := int32(b[0]) | int32(b[1])<<8 | int32(b[2])<<16 | int32(b[3])<<24 + f.appendInt32Slice(v) + b = b[4:] + } + return res, nil + } + if w != WireFixed32 { + return b, errInternalBadWireType + } + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := int32(b[0]) | int32(b[1])<<8 | int32(b[2])<<16 | int32(b[3])<<24 + f.appendInt32Slice(v) + return b[4:], nil +} + +func unmarshalBoolValue(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + // Note: any length varint is allowed, even though any sane + // encoder will use one byte. + // See https://github.com/golang/protobuf/issues/76 + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + // TODO: check if x>1? Tests seem to indicate no. + v := x != 0 + *f.toBool() = v + return b[n:], nil +} + +func unmarshalBoolPtr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + v := x != 0 + *f.toBoolPtr() = &v + return b[n:], nil +} + +func unmarshalBoolSlice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + x, n = decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + v := x != 0 + s := f.toBoolSlice() + *s = append(*s, v) + b = b[n:] + } + return res, nil + } + if w != WireVarint { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + v := x != 0 + s := f.toBoolSlice() + *s = append(*s, v) + return b[n:], nil +} + +func unmarshalFloat64Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed64 { + return b, errInternalBadWireType + } + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := math.Float64frombits(uint64(b[0]) | uint64(b[1])<<8 | uint64(b[2])<<16 | uint64(b[3])<<24 | uint64(b[4])<<32 | uint64(b[5])<<40 | uint64(b[6])<<48 | uint64(b[7])<<56) + *f.toFloat64() = v + return b[8:], nil +} + +func unmarshalFloat64Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed64 { + return b, errInternalBadWireType + } + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := math.Float64frombits(uint64(b[0]) | uint64(b[1])<<8 | uint64(b[2])<<16 | uint64(b[3])<<24 | uint64(b[4])<<32 | uint64(b[5])<<40 | uint64(b[6])<<48 | uint64(b[7])<<56) + *f.toFloat64Ptr() = &v + return b[8:], nil +} + +func unmarshalFloat64Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := math.Float64frombits(uint64(b[0]) | uint64(b[1])<<8 | uint64(b[2])<<16 | uint64(b[3])<<24 | uint64(b[4])<<32 | uint64(b[5])<<40 | uint64(b[6])<<48 | uint64(b[7])<<56) + s := f.toFloat64Slice() + *s = append(*s, v) + b = b[8:] + } + return res, nil + } + if w != WireFixed64 { + return b, errInternalBadWireType + } + if len(b) < 8 { + return nil, io.ErrUnexpectedEOF + } + v := math.Float64frombits(uint64(b[0]) | uint64(b[1])<<8 | uint64(b[2])<<16 | uint64(b[3])<<24 | uint64(b[4])<<32 | uint64(b[5])<<40 | uint64(b[6])<<48 | uint64(b[7])<<56) + s := f.toFloat64Slice() + *s = append(*s, v) + return b[8:], nil +} + +func unmarshalFloat32Value(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed32 { + return b, errInternalBadWireType + } + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := math.Float32frombits(uint32(b[0]) | uint32(b[1])<<8 | uint32(b[2])<<16 | uint32(b[3])<<24) + *f.toFloat32() = v + return b[4:], nil +} + +func unmarshalFloat32Ptr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireFixed32 { + return b, errInternalBadWireType + } + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := math.Float32frombits(uint32(b[0]) | uint32(b[1])<<8 | uint32(b[2])<<16 | uint32(b[3])<<24) + *f.toFloat32Ptr() = &v + return b[4:], nil +} + +func unmarshalFloat32Slice(b []byte, f pointer, w int) ([]byte, error) { + if w == WireBytes { // packed + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + res := b[x:] + b = b[:x] + for len(b) > 0 { + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := math.Float32frombits(uint32(b[0]) | uint32(b[1])<<8 | uint32(b[2])<<16 | uint32(b[3])<<24) + s := f.toFloat32Slice() + *s = append(*s, v) + b = b[4:] + } + return res, nil + } + if w != WireFixed32 { + return b, errInternalBadWireType + } + if len(b) < 4 { + return nil, io.ErrUnexpectedEOF + } + v := math.Float32frombits(uint32(b[0]) | uint32(b[1])<<8 | uint32(b[2])<<16 | uint32(b[3])<<24) + s := f.toFloat32Slice() + *s = append(*s, v) + return b[4:], nil +} + +func unmarshalStringValue(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + v := string(b[:x]) + if !utf8.ValidString(v) { + return nil, errInvalidUTF8 + } + *f.toString() = v + return b[x:], nil +} + +func unmarshalStringPtr(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + v := string(b[:x]) + if !utf8.ValidString(v) { + return nil, errInvalidUTF8 + } + *f.toStringPtr() = &v + return b[x:], nil +} + +func unmarshalStringSlice(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + v := string(b[:x]) + if !utf8.ValidString(v) { + return nil, errInvalidUTF8 + } + s := f.toStringSlice() + *s = append(*s, v) + return b[x:], nil +} + +var emptyBuf [0]byte + +func unmarshalBytesValue(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + // The use of append here is a trick which avoids the zeroing + // that would be required if we used a make/copy pair. + // We append to emptyBuf instead of nil because we want + // a non-nil result even when the length is 0. + v := append(emptyBuf[:], b[:x]...) + *f.toBytes() = v + return b[x:], nil +} + +func unmarshalBytesSlice(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + v := append(emptyBuf[:], b[:x]...) + s := f.toBytesSlice() + *s = append(*s, v) + return b[x:], nil +} + +func makeUnmarshalMessagePtr(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + // First read the message field to see if something is there. + // The semantics of multiple submessages are weird. Instead of + // the last one winning (as it is for all other fields), multiple + // submessages are merged. + v := f.getPointer() + if v.isNil() { + v = valToPointer(reflect.New(sub.typ)) + f.setPointer(v) + } + err := sub.unmarshal(v, b[:x]) + if err != nil { + if r, ok := err.(*RequiredNotSetError); ok { + r.field = name + "." + r.field + } else { + return nil, err + } + } + return b[x:], err + } +} + +func makeUnmarshalMessageSlicePtr(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return b, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + v := valToPointer(reflect.New(sub.typ)) + err := sub.unmarshal(v, b[:x]) + if err != nil { + if r, ok := err.(*RequiredNotSetError); ok { + r.field = name + "." + r.field + } else { + return nil, err + } + } + f.appendPointer(v) + return b[x:], err + } +} + +func makeUnmarshalGroupPtr(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireStartGroup { + return b, errInternalBadWireType + } + x, y := findEndGroup(b) + if x < 0 { + return nil, io.ErrUnexpectedEOF + } + v := f.getPointer() + if v.isNil() { + v = valToPointer(reflect.New(sub.typ)) + f.setPointer(v) + } + err := sub.unmarshal(v, b[:x]) + if err != nil { + if r, ok := err.(*RequiredNotSetError); ok { + r.field = name + "." + r.field + } else { + return nil, err + } + } + return b[y:], err + } +} + +func makeUnmarshalGroupSlicePtr(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireStartGroup { + return b, errInternalBadWireType + } + x, y := findEndGroup(b) + if x < 0 { + return nil, io.ErrUnexpectedEOF + } + v := valToPointer(reflect.New(sub.typ)) + err := sub.unmarshal(v, b[:x]) + if err != nil { + if r, ok := err.(*RequiredNotSetError); ok { + r.field = name + "." + r.field + } else { + return nil, err + } + } + f.appendPointer(v) + return b[y:], err + } +} + +func makeUnmarshalMap(f *reflect.StructField) unmarshaler { + t := f.Type + kt := t.Key() + vt := t.Elem() + tagArray := strings.Split(f.Tag.Get("protobuf"), ",") + valTags := strings.Split(f.Tag.Get("protobuf_val"), ",") + for _, t := range tagArray { + if strings.HasPrefix(t, "customtype=") { + valTags = append(valTags, t) + } + if t == "stdtime" { + valTags = append(valTags, t) + } + if t == "stdduration" { + valTags = append(valTags, t) + } + } + unmarshalKey := typeUnmarshaler(kt, f.Tag.Get("protobuf_key")) + unmarshalVal := typeUnmarshaler(vt, strings.Join(valTags, ",")) + return func(b []byte, f pointer, w int) ([]byte, error) { + // The map entry is a submessage. Figure out how big it is. + if w != WireBytes { + return nil, fmt.Errorf("proto: bad wiretype for map field: got %d want %d", w, WireBytes) + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + r := b[x:] // unused data to return + b = b[:x] // data for map entry + + // Note: we could use #keys * #values ~= 200 functions + // to do map decoding without reflection. Probably not worth it. + // Maps will be somewhat slow. Oh well. + + // Read key and value from data. + k := reflect.New(kt) + v := reflect.New(vt) + for len(b) > 0 { + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + wire := int(x) & 7 + b = b[n:] + + var err error + switch x >> 3 { + case 1: + b, err = unmarshalKey(b, valToPointer(k), wire) + case 2: + b, err = unmarshalVal(b, valToPointer(v), wire) + default: + err = errInternalBadWireType // skip unknown tag + } + + if err == nil { + continue + } + if err != errInternalBadWireType { + return nil, err + } + + // Skip past unknown fields. + b, err = skipField(b, wire) + if err != nil { + return nil, err + } + } + + // Get map, allocate if needed. + m := f.asPointerTo(t).Elem() // an addressable map[K]T + if m.IsNil() { + m.Set(reflect.MakeMap(t)) + } + + // Insert into map. + m.SetMapIndex(k.Elem(), v.Elem()) + + return r, nil + } +} + +// makeUnmarshalOneof makes an unmarshaler for oneof fields. +// for: +// message Msg { +// oneof F { +// int64 X = 1; +// float64 Y = 2; +// } +// } +// typ is the type of the concrete entry for a oneof case (e.g. Msg_X). +// ityp is the interface type of the oneof field (e.g. isMsg_F). +// unmarshal is the unmarshaler for the base type of the oneof case (e.g. int64). +// Note that this function will be called once for each case in the oneof. +func makeUnmarshalOneof(typ, ityp reflect.Type, unmarshal unmarshaler) unmarshaler { + sf := typ.Field(0) + field0 := toField(&sf) + return func(b []byte, f pointer, w int) ([]byte, error) { + // Allocate holder for value. + v := reflect.New(typ) + + // Unmarshal data into holder. + // We unmarshal into the first field of the holder object. + var err error + b, err = unmarshal(b, valToPointer(v).offset(field0), w) + if err != nil { + return nil, err + } + + // Write pointer to holder into target field. + f.asPointerTo(ityp).Elem().Set(v) + + return b, nil + } +} + +// Error used by decode internally. +var errInternalBadWireType = errors.New("proto: internal error: bad wiretype") + +// skipField skips past a field of type wire and returns the remaining bytes. +func skipField(b []byte, wire int) ([]byte, error) { + switch wire { + case WireVarint: + _, k := decodeVarint(b) + if k == 0 { + return b, io.ErrUnexpectedEOF + } + b = b[k:] + case WireFixed32: + if len(b) < 4 { + return b, io.ErrUnexpectedEOF + } + b = b[4:] + case WireFixed64: + if len(b) < 8 { + return b, io.ErrUnexpectedEOF + } + b = b[8:] + case WireBytes: + m, k := decodeVarint(b) + if k == 0 || uint64(len(b)-k) < m { + return b, io.ErrUnexpectedEOF + } + b = b[uint64(k)+m:] + case WireStartGroup: + _, i := findEndGroup(b) + if i == -1 { + return b, io.ErrUnexpectedEOF + } + b = b[i:] + default: + return b, fmt.Errorf("proto: can't skip unknown wire type %d", wire) + } + return b, nil +} + +// findEndGroup finds the index of the next EndGroup tag. +// Groups may be nested, so the "next" EndGroup tag is the first +// unpaired EndGroup. +// findEndGroup returns the indexes of the start and end of the EndGroup tag. +// Returns (-1,-1) if it can't find one. +func findEndGroup(b []byte) (int, int) { + depth := 1 + i := 0 + for { + x, n := decodeVarint(b[i:]) + if n == 0 { + return -1, -1 + } + j := i + i += n + switch x & 7 { + case WireVarint: + _, k := decodeVarint(b[i:]) + if k == 0 { + return -1, -1 + } + i += k + case WireFixed32: + if len(b)-4 < i { + return -1, -1 + } + i += 4 + case WireFixed64: + if len(b)-8 < i { + return -1, -1 + } + i += 8 + case WireBytes: + m, k := decodeVarint(b[i:]) + if k == 0 { + return -1, -1 + } + i += k + if uint64(len(b)-i) < m { + return -1, -1 + } + i += int(m) + case WireStartGroup: + depth++ + case WireEndGroup: + depth-- + if depth == 0 { + return j, i + } + default: + return -1, -1 + } + } +} + +// encodeVarint appends a varint-encoded integer to b and returns the result. +func encodeVarint(b []byte, x uint64) []byte { + for x >= 1<<7 { + b = append(b, byte(x&0x7f|0x80)) + x >>= 7 + } + return append(b, byte(x)) +} + +// decodeVarint reads a varint-encoded integer from b. +// Returns the decoded integer and the number of bytes read. +// If there is an error, it returns 0,0. +func decodeVarint(b []byte) (uint64, int) { + var x, y uint64 + if len(b) <= 0 { + goto bad + } + x = uint64(b[0]) + if x < 0x80 { + return x, 1 + } + x -= 0x80 + + if len(b) <= 1 { + goto bad + } + y = uint64(b[1]) + x += y << 7 + if y < 0x80 { + return x, 2 + } + x -= 0x80 << 7 + + if len(b) <= 2 { + goto bad + } + y = uint64(b[2]) + x += y << 14 + if y < 0x80 { + return x, 3 + } + x -= 0x80 << 14 + + if len(b) <= 3 { + goto bad + } + y = uint64(b[3]) + x += y << 21 + if y < 0x80 { + return x, 4 + } + x -= 0x80 << 21 + + if len(b) <= 4 { + goto bad + } + y = uint64(b[4]) + x += y << 28 + if y < 0x80 { + return x, 5 + } + x -= 0x80 << 28 + + if len(b) <= 5 { + goto bad + } + y = uint64(b[5]) + x += y << 35 + if y < 0x80 { + return x, 6 + } + x -= 0x80 << 35 + + if len(b) <= 6 { + goto bad + } + y = uint64(b[6]) + x += y << 42 + if y < 0x80 { + return x, 7 + } + x -= 0x80 << 42 + + if len(b) <= 7 { + goto bad + } + y = uint64(b[7]) + x += y << 49 + if y < 0x80 { + return x, 8 + } + x -= 0x80 << 49 + + if len(b) <= 8 { + goto bad + } + y = uint64(b[8]) + x += y << 56 + if y < 0x80 { + return x, 9 + } + x -= 0x80 << 56 + + if len(b) <= 9 { + goto bad + } + y = uint64(b[9]) + x += y << 63 + if y < 2 { + return x, 10 + } + +bad: + return 0, 0 +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/table_unmarshal_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/table_unmarshal_gogo.go new file mode 100644 index 000000000000..00d6c7ad9376 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/table_unmarshal_gogo.go @@ -0,0 +1,385 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2018, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "io" + "reflect" +) + +func makeUnmarshalMessage(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + // First read the message field to see if something is there. + // The semantics of multiple submessages are weird. Instead of + // the last one winning (as it is for all other fields), multiple + // submessages are merged. + v := f // gogo: changed from v := f.getPointer() + if v.isNil() { + v = valToPointer(reflect.New(sub.typ)) + f.setPointer(v) + } + err := sub.unmarshal(v, b[:x]) + if err != nil { + if r, ok := err.(*RequiredNotSetError); ok { + r.field = name + "." + r.field + } else { + return nil, err + } + } + return b[x:], err + } +} + +func makeUnmarshalMessageSlice(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + v := valToPointer(reflect.New(sub.typ)) + err := sub.unmarshal(v, b[:x]) + if err != nil { + if r, ok := err.(*RequiredNotSetError); ok { + r.field = name + "." + r.field + } else { + return nil, err + } + } + f.appendRef(v, sub.typ) // gogo: changed from f.appendPointer(v) + return b[x:], err + } +} + +func makeUnmarshalCustomPtr(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + + s := f.asPointerTo(reflect.PtrTo(sub.typ)).Elem() + s.Set(reflect.New(sub.typ)) + m := s.Interface().(custom) + if err := m.Unmarshal(b[:x]); err != nil { + return nil, err + } + return b[x:], nil + } +} + +func makeUnmarshalCustomSlice(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + m := reflect.New(sub.typ) + c := m.Interface().(custom) + if err := c.Unmarshal(b[:x]); err != nil { + return nil, err + } + v := valToPointer(m) + f.appendRef(v, sub.typ) + return b[x:], nil + } +} + +func makeUnmarshalCustom(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + + m := f.asPointerTo(sub.typ).Interface().(custom) + if err := m.Unmarshal(b[:x]); err != nil { + return nil, err + } + return b[x:], nil + } +} + +func makeUnmarshalTime(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + m := ×tamp{} + if err := Unmarshal(b[:x], m); err != nil { + return nil, err + } + t, err := timestampFromProto(m) + if err != nil { + return nil, err + } + s := f.asPointerTo(sub.typ).Elem() + s.Set(reflect.ValueOf(t)) + return b[x:], nil + } +} + +func makeUnmarshalTimePtr(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + m := ×tamp{} + if err := Unmarshal(b[:x], m); err != nil { + return nil, err + } + t, err := timestampFromProto(m) + if err != nil { + return nil, err + } + s := f.asPointerTo(reflect.PtrTo(sub.typ)).Elem() + s.Set(reflect.ValueOf(&t)) + return b[x:], nil + } +} + +func makeUnmarshalTimePtrSlice(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + m := ×tamp{} + if err := Unmarshal(b[:x], m); err != nil { + return nil, err + } + t, err := timestampFromProto(m) + if err != nil { + return nil, err + } + slice := f.getSlice(reflect.PtrTo(sub.typ)) + newSlice := reflect.Append(slice, reflect.ValueOf(&t)) + slice.Set(newSlice) + return b[x:], nil + } +} + +func makeUnmarshalTimeSlice(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + m := ×tamp{} + if err := Unmarshal(b[:x], m); err != nil { + return nil, err + } + t, err := timestampFromProto(m) + if err != nil { + return nil, err + } + slice := f.getSlice(sub.typ) + newSlice := reflect.Append(slice, reflect.ValueOf(t)) + slice.Set(newSlice) + return b[x:], nil + } +} + +func makeUnmarshalDurationPtr(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + m := &duration{} + if err := Unmarshal(b[:x], m); err != nil { + return nil, err + } + d, err := durationFromProto(m) + if err != nil { + return nil, err + } + s := f.asPointerTo(reflect.PtrTo(sub.typ)).Elem() + s.Set(reflect.ValueOf(&d)) + return b[x:], nil + } +} + +func makeUnmarshalDuration(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + m := &duration{} + if err := Unmarshal(b[:x], m); err != nil { + return nil, err + } + d, err := durationFromProto(m) + if err != nil { + return nil, err + } + s := f.asPointerTo(sub.typ).Elem() + s.Set(reflect.ValueOf(d)) + return b[x:], nil + } +} + +func makeUnmarshalDurationPtrSlice(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + m := &duration{} + if err := Unmarshal(b[:x], m); err != nil { + return nil, err + } + d, err := durationFromProto(m) + if err != nil { + return nil, err + } + slice := f.getSlice(reflect.PtrTo(sub.typ)) + newSlice := reflect.Append(slice, reflect.ValueOf(&d)) + slice.Set(newSlice) + return b[x:], nil + } +} + +func makeUnmarshalDurationSlice(sub *unmarshalInfo, name string) unmarshaler { + return func(b []byte, f pointer, w int) ([]byte, error) { + if w != WireBytes { + return nil, errInternalBadWireType + } + x, n := decodeVarint(b) + if n == 0 { + return nil, io.ErrUnexpectedEOF + } + b = b[n:] + if x > uint64(len(b)) { + return nil, io.ErrUnexpectedEOF + } + m := &duration{} + if err := Unmarshal(b[:x], m); err != nil { + return nil, err + } + d, err := durationFromProto(m) + if err != nil { + return nil, err + } + slice := f.getSlice(sub.typ) + newSlice := reflect.Append(slice, reflect.ValueOf(d)) + slice.Set(newSlice) + return b[x:], nil + } +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/text.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/text.go new file mode 100644 index 000000000000..4f5706dc5f36 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/text.go @@ -0,0 +1,928 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2013, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +// Functions for writing the text protocol buffer format. + +import ( + "bufio" + "bytes" + "encoding" + "errors" + "fmt" + "io" + "log" + "math" + "reflect" + "sort" + "strings" + "sync" + "time" +) + +var ( + newline = []byte("\n") + spaces = []byte(" ") + endBraceNewline = []byte("}\n") + backslashN = []byte{'\\', 'n'} + backslashR = []byte{'\\', 'r'} + backslashT = []byte{'\\', 't'} + backslashDQ = []byte{'\\', '"'} + backslashBS = []byte{'\\', '\\'} + posInf = []byte("inf") + negInf = []byte("-inf") + nan = []byte("nan") +) + +type writer interface { + io.Writer + WriteByte(byte) error +} + +// textWriter is an io.Writer that tracks its indentation level. +type textWriter struct { + ind int + complete bool // if the current position is a complete line + compact bool // whether to write out as a one-liner + w writer +} + +func (w *textWriter) WriteString(s string) (n int, err error) { + if !strings.Contains(s, "\n") { + if !w.compact && w.complete { + w.writeIndent() + } + w.complete = false + return io.WriteString(w.w, s) + } + // WriteString is typically called without newlines, so this + // codepath and its copy are rare. We copy to avoid + // duplicating all of Write's logic here. + return w.Write([]byte(s)) +} + +func (w *textWriter) Write(p []byte) (n int, err error) { + newlines := bytes.Count(p, newline) + if newlines == 0 { + if !w.compact && w.complete { + w.writeIndent() + } + n, err = w.w.Write(p) + w.complete = false + return n, err + } + + frags := bytes.SplitN(p, newline, newlines+1) + if w.compact { + for i, frag := range frags { + if i > 0 { + if err := w.w.WriteByte(' '); err != nil { + return n, err + } + n++ + } + nn, err := w.w.Write(frag) + n += nn + if err != nil { + return n, err + } + } + return n, nil + } + + for i, frag := range frags { + if w.complete { + w.writeIndent() + } + nn, err := w.w.Write(frag) + n += nn + if err != nil { + return n, err + } + if i+1 < len(frags) { + if err := w.w.WriteByte('\n'); err != nil { + return n, err + } + n++ + } + } + w.complete = len(frags[len(frags)-1]) == 0 + return n, nil +} + +func (w *textWriter) WriteByte(c byte) error { + if w.compact && c == '\n' { + c = ' ' + } + if !w.compact && w.complete { + w.writeIndent() + } + err := w.w.WriteByte(c) + w.complete = c == '\n' + return err +} + +func (w *textWriter) indent() { w.ind++ } + +func (w *textWriter) unindent() { + if w.ind == 0 { + log.Print("proto: textWriter unindented too far") + return + } + w.ind-- +} + +func writeName(w *textWriter, props *Properties) error { + if _, err := w.WriteString(props.OrigName); err != nil { + return err + } + if props.Wire != "group" { + return w.WriteByte(':') + } + return nil +} + +func requiresQuotes(u string) bool { + // When type URL contains any characters except [0-9A-Za-z./\-]*, it must be quoted. + for _, ch := range u { + switch { + case ch == '.' || ch == '/' || ch == '_': + continue + case '0' <= ch && ch <= '9': + continue + case 'A' <= ch && ch <= 'Z': + continue + case 'a' <= ch && ch <= 'z': + continue + default: + return true + } + } + return false +} + +// isAny reports whether sv is a google.protobuf.Any message +func isAny(sv reflect.Value) bool { + type wkt interface { + XXX_WellKnownType() string + } + t, ok := sv.Addr().Interface().(wkt) + return ok && t.XXX_WellKnownType() == "Any" +} + +// writeProto3Any writes an expanded google.protobuf.Any message. +// +// It returns (false, nil) if sv value can't be unmarshaled (e.g. because +// required messages are not linked in). +// +// It returns (true, error) when sv was written in expanded format or an error +// was encountered. +func (tm *TextMarshaler) writeProto3Any(w *textWriter, sv reflect.Value) (bool, error) { + turl := sv.FieldByName("TypeUrl") + val := sv.FieldByName("Value") + if !turl.IsValid() || !val.IsValid() { + return true, errors.New("proto: invalid google.protobuf.Any message") + } + + b, ok := val.Interface().([]byte) + if !ok { + return true, errors.New("proto: invalid google.protobuf.Any message") + } + + parts := strings.Split(turl.String(), "/") + mt := MessageType(parts[len(parts)-1]) + if mt == nil { + return false, nil + } + m := reflect.New(mt.Elem()) + if err := Unmarshal(b, m.Interface().(Message)); err != nil { + return false, nil + } + w.Write([]byte("[")) + u := turl.String() + if requiresQuotes(u) { + writeString(w, u) + } else { + w.Write([]byte(u)) + } + if w.compact { + w.Write([]byte("]:<")) + } else { + w.Write([]byte("]: <\n")) + w.ind++ + } + if err := tm.writeStruct(w, m.Elem()); err != nil { + return true, err + } + if w.compact { + w.Write([]byte("> ")) + } else { + w.ind-- + w.Write([]byte(">\n")) + } + return true, nil +} + +func (tm *TextMarshaler) writeStruct(w *textWriter, sv reflect.Value) error { + if tm.ExpandAny && isAny(sv) { + if canExpand, err := tm.writeProto3Any(w, sv); canExpand { + return err + } + } + st := sv.Type() + sprops := GetProperties(st) + for i := 0; i < sv.NumField(); i++ { + fv := sv.Field(i) + props := sprops.Prop[i] + name := st.Field(i).Name + + if name == "XXX_NoUnkeyedLiteral" { + continue + } + + if strings.HasPrefix(name, "XXX_") { + // There are two XXX_ fields: + // XXX_unrecognized []byte + // XXX_extensions map[int32]proto.Extension + // The first is handled here; + // the second is handled at the bottom of this function. + if name == "XXX_unrecognized" && !fv.IsNil() { + if err := writeUnknownStruct(w, fv.Interface().([]byte)); err != nil { + return err + } + } + continue + } + if fv.Kind() == reflect.Ptr && fv.IsNil() { + // Field not filled in. This could be an optional field or + // a required field that wasn't filled in. Either way, there + // isn't anything we can show for it. + continue + } + if fv.Kind() == reflect.Slice && fv.IsNil() { + // Repeated field that is empty, or a bytes field that is unused. + continue + } + + if props.Repeated && fv.Kind() == reflect.Slice { + // Repeated field. + for j := 0; j < fv.Len(); j++ { + if err := writeName(w, props); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + v := fv.Index(j) + if v.Kind() == reflect.Ptr && v.IsNil() { + // A nil message in a repeated field is not valid, + // but we can handle that more gracefully than panicking. + if _, err := w.Write([]byte("\n")); err != nil { + return err + } + continue + } + if len(props.Enum) > 0 { + if err := tm.writeEnum(w, v, props); err != nil { + return err + } + } else if err := tm.writeAny(w, v, props); err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + } + continue + } + if fv.Kind() == reflect.Map { + // Map fields are rendered as a repeated struct with key/value fields. + keys := fv.MapKeys() + sort.Sort(mapKeys(keys)) + for _, key := range keys { + val := fv.MapIndex(key) + if err := writeName(w, props); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + // open struct + if err := w.WriteByte('<'); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte('\n'); err != nil { + return err + } + } + w.indent() + // key + if _, err := w.WriteString("key:"); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + if err := tm.writeAny(w, key, props.mkeyprop); err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + // nil values aren't legal, but we can avoid panicking because of them. + if val.Kind() != reflect.Ptr || !val.IsNil() { + // value + if _, err := w.WriteString("value:"); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + if err := tm.writeAny(w, val, props.mvalprop); err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + } + // close struct + w.unindent() + if err := w.WriteByte('>'); err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + } + continue + } + if props.proto3 && fv.Kind() == reflect.Slice && fv.Len() == 0 { + // empty bytes field + continue + } + if props.proto3 && fv.Kind() != reflect.Ptr && fv.Kind() != reflect.Slice { + // proto3 non-repeated scalar field; skip if zero value + if isProto3Zero(fv) { + continue + } + } + + if fv.Kind() == reflect.Interface { + // Check if it is a oneof. + if st.Field(i).Tag.Get("protobuf_oneof") != "" { + // fv is nil, or holds a pointer to generated struct. + // That generated struct has exactly one field, + // which has a protobuf struct tag. + if fv.IsNil() { + continue + } + inner := fv.Elem().Elem() // interface -> *T -> T + tag := inner.Type().Field(0).Tag.Get("protobuf") + props = new(Properties) // Overwrite the outer props var, but not its pointee. + props.Parse(tag) + // Write the value in the oneof, not the oneof itself. + fv = inner.Field(0) + + // Special case to cope with malformed messages gracefully: + // If the value in the oneof is a nil pointer, don't panic + // in writeAny. + if fv.Kind() == reflect.Ptr && fv.IsNil() { + // Use errors.New so writeAny won't render quotes. + msg := errors.New("/* nil */") + fv = reflect.ValueOf(&msg).Elem() + } + } + } + + if err := writeName(w, props); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + + if len(props.Enum) > 0 { + if err := tm.writeEnum(w, fv, props); err != nil { + return err + } + } else if err := tm.writeAny(w, fv, props); err != nil { + return err + } + + if err := w.WriteByte('\n'); err != nil { + return err + } + } + + // Extensions (the XXX_extensions field). + pv := sv + if pv.CanAddr() { + pv = sv.Addr() + } else { + pv = reflect.New(sv.Type()) + pv.Elem().Set(sv) + } + if _, err := extendable(pv.Interface()); err == nil { + if err := tm.writeExtensions(w, pv); err != nil { + return err + } + } + + return nil +} + +// writeAny writes an arbitrary field. +func (tm *TextMarshaler) writeAny(w *textWriter, v reflect.Value, props *Properties) error { + v = reflect.Indirect(v) + + if props != nil { + if len(props.CustomType) > 0 { + custom, ok := v.Interface().(Marshaler) + if ok { + data, err := custom.Marshal() + if err != nil { + return err + } + if err := writeString(w, string(data)); err != nil { + return err + } + return nil + } + } else if len(props.CastType) > 0 { + if _, ok := v.Interface().(interface { + String() string + }); ok { + switch v.Kind() { + case reflect.Int, reflect.Int8, reflect.Int16, reflect.Int32, reflect.Int64, + reflect.Uint, reflect.Uint8, reflect.Uint16, reflect.Uint32, reflect.Uint64: + _, err := fmt.Fprintf(w, "%d", v.Interface()) + return err + } + } + } else if props.StdTime { + t, ok := v.Interface().(time.Time) + if !ok { + return fmt.Errorf("stdtime is not time.Time, but %T", v.Interface()) + } + tproto, err := timestampProto(t) + if err != nil { + return err + } + propsCopy := *props // Make a copy so that this is goroutine-safe + propsCopy.StdTime = false + err = tm.writeAny(w, reflect.ValueOf(tproto), &propsCopy) + return err + } else if props.StdDuration { + d, ok := v.Interface().(time.Duration) + if !ok { + return fmt.Errorf("stdtime is not time.Duration, but %T", v.Interface()) + } + dproto := durationProto(d) + propsCopy := *props // Make a copy so that this is goroutine-safe + propsCopy.StdDuration = false + err := tm.writeAny(w, reflect.ValueOf(dproto), &propsCopy) + return err + } + } + + // Floats have special cases. + if v.Kind() == reflect.Float32 || v.Kind() == reflect.Float64 { + x := v.Float() + var b []byte + switch { + case math.IsInf(x, 1): + b = posInf + case math.IsInf(x, -1): + b = negInf + case math.IsNaN(x): + b = nan + } + if b != nil { + _, err := w.Write(b) + return err + } + // Other values are handled below. + } + + // We don't attempt to serialise every possible value type; only those + // that can occur in protocol buffers. + switch v.Kind() { + case reflect.Slice: + // Should only be a []byte; repeated fields are handled in writeStruct. + if err := writeString(w, string(v.Bytes())); err != nil { + return err + } + case reflect.String: + if err := writeString(w, v.String()); err != nil { + return err + } + case reflect.Struct: + // Required/optional group/message. + var bra, ket byte = '<', '>' + if props != nil && props.Wire == "group" { + bra, ket = '{', '}' + } + if err := w.WriteByte(bra); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte('\n'); err != nil { + return err + } + } + w.indent() + if v.CanAddr() { + // Calling v.Interface on a struct causes the reflect package to + // copy the entire struct. This is racy with the new Marshaler + // since we atomically update the XXX_sizecache. + // + // Thus, we retrieve a pointer to the struct if possible to avoid + // a race since v.Interface on the pointer doesn't copy the struct. + // + // If v is not addressable, then we are not worried about a race + // since it implies that the binary Marshaler cannot possibly be + // mutating this value. + v = v.Addr() + } + if etm, ok := v.Interface().(encoding.TextMarshaler); ok { + text, err := etm.MarshalText() + if err != nil { + return err + } + if _, err = w.Write(text); err != nil { + return err + } + } else { + if v.Kind() == reflect.Ptr { + v = v.Elem() + } + if err := tm.writeStruct(w, v); err != nil { + return err + } + } + w.unindent() + if err := w.WriteByte(ket); err != nil { + return err + } + default: + _, err := fmt.Fprint(w, v.Interface()) + return err + } + return nil +} + +// equivalent to C's isprint. +func isprint(c byte) bool { + return c >= 0x20 && c < 0x7f +} + +// writeString writes a string in the protocol buffer text format. +// It is similar to strconv.Quote except we don't use Go escape sequences, +// we treat the string as a byte sequence, and we use octal escapes. +// These differences are to maintain interoperability with the other +// languages' implementations of the text format. +func writeString(w *textWriter, s string) error { + // use WriteByte here to get any needed indent + if err := w.WriteByte('"'); err != nil { + return err + } + // Loop over the bytes, not the runes. + for i := 0; i < len(s); i++ { + var err error + // Divergence from C++: we don't escape apostrophes. + // There's no need to escape them, and the C++ parser + // copes with a naked apostrophe. + switch c := s[i]; c { + case '\n': + _, err = w.w.Write(backslashN) + case '\r': + _, err = w.w.Write(backslashR) + case '\t': + _, err = w.w.Write(backslashT) + case '"': + _, err = w.w.Write(backslashDQ) + case '\\': + _, err = w.w.Write(backslashBS) + default: + if isprint(c) { + err = w.w.WriteByte(c) + } else { + _, err = fmt.Fprintf(w.w, "\\%03o", c) + } + } + if err != nil { + return err + } + } + return w.WriteByte('"') +} + +func writeUnknownStruct(w *textWriter, data []byte) (err error) { + if !w.compact { + if _, err := fmt.Fprintf(w, "/* %d unknown bytes */\n", len(data)); err != nil { + return err + } + } + b := NewBuffer(data) + for b.index < len(b.buf) { + x, err := b.DecodeVarint() + if err != nil { + _, ferr := fmt.Fprintf(w, "/* %v */\n", err) + return ferr + } + wire, tag := x&7, x>>3 + if wire == WireEndGroup { + w.unindent() + if _, werr := w.Write(endBraceNewline); werr != nil { + return werr + } + continue + } + if _, ferr := fmt.Fprint(w, tag); ferr != nil { + return ferr + } + if wire != WireStartGroup { + if err = w.WriteByte(':'); err != nil { + return err + } + } + if !w.compact || wire == WireStartGroup { + if err = w.WriteByte(' '); err != nil { + return err + } + } + switch wire { + case WireBytes: + buf, e := b.DecodeRawBytes(false) + if e == nil { + _, err = fmt.Fprintf(w, "%q", buf) + } else { + _, err = fmt.Fprintf(w, "/* %v */", e) + } + case WireFixed32: + x, err = b.DecodeFixed32() + err = writeUnknownInt(w, x, err) + case WireFixed64: + x, err = b.DecodeFixed64() + err = writeUnknownInt(w, x, err) + case WireStartGroup: + err = w.WriteByte('{') + w.indent() + case WireVarint: + x, err = b.DecodeVarint() + err = writeUnknownInt(w, x, err) + default: + _, err = fmt.Fprintf(w, "/* unknown wire type %d */", wire) + } + if err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + } + return nil +} + +func writeUnknownInt(w *textWriter, x uint64, err error) error { + if err == nil { + _, err = fmt.Fprint(w, x) + } else { + _, err = fmt.Fprintf(w, "/* %v */", err) + } + return err +} + +type int32Slice []int32 + +func (s int32Slice) Len() int { return len(s) } +func (s int32Slice) Less(i, j int) bool { return s[i] < s[j] } +func (s int32Slice) Swap(i, j int) { s[i], s[j] = s[j], s[i] } + +// writeExtensions writes all the extensions in pv. +// pv is assumed to be a pointer to a protocol message struct that is extendable. +func (tm *TextMarshaler) writeExtensions(w *textWriter, pv reflect.Value) error { + emap := extensionMaps[pv.Type().Elem()] + e := pv.Interface().(Message) + + var m map[int32]Extension + var mu sync.Locker + if em, ok := e.(extensionsBytes); ok { + eb := em.GetExtensions() + var err error + m, err = BytesToExtensionsMap(*eb) + if err != nil { + return err + } + mu = notLocker{} + } else if _, ok := e.(extendableProto); ok { + ep, _ := extendable(e) + m, mu = ep.extensionsRead() + if m == nil { + return nil + } + } + + // Order the extensions by ID. + // This isn't strictly necessary, but it will give us + // canonical output, which will also make testing easier. + + mu.Lock() + ids := make([]int32, 0, len(m)) + for id := range m { + ids = append(ids, id) + } + sort.Sort(int32Slice(ids)) + mu.Unlock() + + for _, extNum := range ids { + ext := m[extNum] + var desc *ExtensionDesc + if emap != nil { + desc = emap[extNum] + } + if desc == nil { + // Unknown extension. + if err := writeUnknownStruct(w, ext.enc); err != nil { + return err + } + continue + } + + pb, err := GetExtension(e, desc) + if err != nil { + return fmt.Errorf("failed getting extension: %v", err) + } + + // Repeated extensions will appear as a slice. + if !desc.repeated() { + if err := tm.writeExtension(w, desc.Name, pb); err != nil { + return err + } + } else { + v := reflect.ValueOf(pb) + for i := 0; i < v.Len(); i++ { + if err := tm.writeExtension(w, desc.Name, v.Index(i).Interface()); err != nil { + return err + } + } + } + } + return nil +} + +func (tm *TextMarshaler) writeExtension(w *textWriter, name string, pb interface{}) error { + if _, err := fmt.Fprintf(w, "[%s]:", name); err != nil { + return err + } + if !w.compact { + if err := w.WriteByte(' '); err != nil { + return err + } + } + if err := tm.writeAny(w, reflect.ValueOf(pb), nil); err != nil { + return err + } + if err := w.WriteByte('\n'); err != nil { + return err + } + return nil +} + +func (w *textWriter) writeIndent() { + if !w.complete { + return + } + remain := w.ind * 2 + for remain > 0 { + n := remain + if n > len(spaces) { + n = len(spaces) + } + w.w.Write(spaces[:n]) + remain -= n + } + w.complete = false +} + +// TextMarshaler is a configurable text format marshaler. +type TextMarshaler struct { + Compact bool // use compact text format (one line). + ExpandAny bool // expand google.protobuf.Any messages of known types +} + +// Marshal writes a given protocol buffer in text format. +// The only errors returned are from w. +func (tm *TextMarshaler) Marshal(w io.Writer, pb Message) error { + val := reflect.ValueOf(pb) + if pb == nil || val.IsNil() { + w.Write([]byte("")) + return nil + } + var bw *bufio.Writer + ww, ok := w.(writer) + if !ok { + bw = bufio.NewWriter(w) + ww = bw + } + aw := &textWriter{ + w: ww, + complete: true, + compact: tm.Compact, + } + + if etm, ok := pb.(encoding.TextMarshaler); ok { + text, err := etm.MarshalText() + if err != nil { + return err + } + if _, err = aw.Write(text); err != nil { + return err + } + if bw != nil { + return bw.Flush() + } + return nil + } + // Dereference the received pointer so we don't have outer < and >. + v := reflect.Indirect(val) + if err := tm.writeStruct(aw, v); err != nil { + return err + } + if bw != nil { + return bw.Flush() + } + return nil +} + +// Text is the same as Marshal, but returns the string directly. +func (tm *TextMarshaler) Text(pb Message) string { + var buf bytes.Buffer + tm.Marshal(&buf, pb) + return buf.String() +} + +var ( + defaultTextMarshaler = TextMarshaler{} + compactTextMarshaler = TextMarshaler{Compact: true} +) + +// TODO: consider removing some of the Marshal functions below. + +// MarshalText writes a given protocol buffer in text format. +// The only errors returned are from w. +func MarshalText(w io.Writer, pb Message) error { return defaultTextMarshaler.Marshal(w, pb) } + +// MarshalTextString is the same as MarshalText, but returns the string directly. +func MarshalTextString(pb Message) string { return defaultTextMarshaler.Text(pb) } + +// CompactText writes a given protocol buffer in compact text format (one line). +func CompactText(w io.Writer, pb Message) error { return compactTextMarshaler.Marshal(w, pb) } + +// CompactTextString is the same as CompactText, but returns the string directly. +func CompactTextString(pb Message) string { return compactTextMarshaler.Text(pb) } diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/text_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/text_gogo.go new file mode 100644 index 000000000000..1d6c6aa0e41b --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/text_gogo.go @@ -0,0 +1,57 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2013, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "fmt" + "reflect" +) + +func (tm *TextMarshaler) writeEnum(w *textWriter, v reflect.Value, props *Properties) error { + m, ok := enumStringMaps[props.Enum] + if !ok { + if err := tm.writeAny(w, v, props); err != nil { + return err + } + } + key := int32(0) + if v.Kind() == reflect.Ptr { + key = int32(v.Elem().Int()) + } else { + key = int32(v.Int()) + } + s, ok := m[key] + if !ok { + if err := tm.writeAny(w, v, props); err != nil { + return err + } + } + _, err := fmt.Fprint(w, s) + return err +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/text_parser.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/text_parser.go new file mode 100644 index 000000000000..fbb000d3742a --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/text_parser.go @@ -0,0 +1,998 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2013, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2010 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +// Functions for parsing the Text protocol buffer format. +// TODO: message sets. + +import ( + "encoding" + "errors" + "fmt" + "reflect" + "strconv" + "strings" + "time" + "unicode/utf8" +) + +// Error string emitted when deserializing Any and fields are already set +const anyRepeatedlyUnpacked = "Any message unpacked multiple times, or %q already set" + +type ParseError struct { + Message string + Line int // 1-based line number + Offset int // 0-based byte offset from start of input +} + +func (p *ParseError) Error() string { + if p.Line == 1 { + // show offset only for first line + return fmt.Sprintf("line 1.%d: %v", p.Offset, p.Message) + } + return fmt.Sprintf("line %d: %v", p.Line, p.Message) +} + +type token struct { + value string + err *ParseError + line int // line number + offset int // byte number from start of input, not start of line + unquoted string // the unquoted version of value, if it was a quoted string +} + +func (t *token) String() string { + if t.err == nil { + return fmt.Sprintf("%q (line=%d, offset=%d)", t.value, t.line, t.offset) + } + return fmt.Sprintf("parse error: %v", t.err) +} + +type textParser struct { + s string // remaining input + done bool // whether the parsing is finished (success or error) + backed bool // whether back() was called + offset, line int + cur token +} + +func newTextParser(s string) *textParser { + p := new(textParser) + p.s = s + p.line = 1 + p.cur.line = 1 + return p +} + +func (p *textParser) errorf(format string, a ...interface{}) *ParseError { + pe := &ParseError{fmt.Sprintf(format, a...), p.cur.line, p.cur.offset} + p.cur.err = pe + p.done = true + return pe +} + +// Numbers and identifiers are matched by [-+._A-Za-z0-9] +func isIdentOrNumberChar(c byte) bool { + switch { + case 'A' <= c && c <= 'Z', 'a' <= c && c <= 'z': + return true + case '0' <= c && c <= '9': + return true + } + switch c { + case '-', '+', '.', '_': + return true + } + return false +} + +func isWhitespace(c byte) bool { + switch c { + case ' ', '\t', '\n', '\r': + return true + } + return false +} + +func isQuote(c byte) bool { + switch c { + case '"', '\'': + return true + } + return false +} + +func (p *textParser) skipWhitespace() { + i := 0 + for i < len(p.s) && (isWhitespace(p.s[i]) || p.s[i] == '#') { + if p.s[i] == '#' { + // comment; skip to end of line or input + for i < len(p.s) && p.s[i] != '\n' { + i++ + } + if i == len(p.s) { + break + } + } + if p.s[i] == '\n' { + p.line++ + } + i++ + } + p.offset += i + p.s = p.s[i:len(p.s)] + if len(p.s) == 0 { + p.done = true + } +} + +func (p *textParser) advance() { + // Skip whitespace + p.skipWhitespace() + if p.done { + return + } + + // Start of non-whitespace + p.cur.err = nil + p.cur.offset, p.cur.line = p.offset, p.line + p.cur.unquoted = "" + switch p.s[0] { + case '<', '>', '{', '}', ':', '[', ']', ';', ',', '/': + // Single symbol + p.cur.value, p.s = p.s[0:1], p.s[1:len(p.s)] + case '"', '\'': + // Quoted string + i := 1 + for i < len(p.s) && p.s[i] != p.s[0] && p.s[i] != '\n' { + if p.s[i] == '\\' && i+1 < len(p.s) { + // skip escaped char + i++ + } + i++ + } + if i >= len(p.s) || p.s[i] != p.s[0] { + p.errorf("unmatched quote") + return + } + unq, err := unquoteC(p.s[1:i], rune(p.s[0])) + if err != nil { + p.errorf("invalid quoted string %s: %v", p.s[0:i+1], err) + return + } + p.cur.value, p.s = p.s[0:i+1], p.s[i+1:len(p.s)] + p.cur.unquoted = unq + default: + i := 0 + for i < len(p.s) && isIdentOrNumberChar(p.s[i]) { + i++ + } + if i == 0 { + p.errorf("unexpected byte %#x", p.s[0]) + return + } + p.cur.value, p.s = p.s[0:i], p.s[i:len(p.s)] + } + p.offset += len(p.cur.value) +} + +var ( + errBadUTF8 = errors.New("proto: bad UTF-8") +) + +func unquoteC(s string, quote rune) (string, error) { + // This is based on C++'s tokenizer.cc. + // Despite its name, this is *not* parsing C syntax. + // For instance, "\0" is an invalid quoted string. + + // Avoid allocation in trivial cases. + simple := true + for _, r := range s { + if r == '\\' || r == quote { + simple = false + break + } + } + if simple { + return s, nil + } + + buf := make([]byte, 0, 3*len(s)/2) + for len(s) > 0 { + r, n := utf8.DecodeRuneInString(s) + if r == utf8.RuneError && n == 1 { + return "", errBadUTF8 + } + s = s[n:] + if r != '\\' { + if r < utf8.RuneSelf { + buf = append(buf, byte(r)) + } else { + buf = append(buf, string(r)...) + } + continue + } + + ch, tail, err := unescape(s) + if err != nil { + return "", err + } + buf = append(buf, ch...) + s = tail + } + return string(buf), nil +} + +func unescape(s string) (ch string, tail string, err error) { + r, n := utf8.DecodeRuneInString(s) + if r == utf8.RuneError && n == 1 { + return "", "", errBadUTF8 + } + s = s[n:] + switch r { + case 'a': + return "\a", s, nil + case 'b': + return "\b", s, nil + case 'f': + return "\f", s, nil + case 'n': + return "\n", s, nil + case 'r': + return "\r", s, nil + case 't': + return "\t", s, nil + case 'v': + return "\v", s, nil + case '?': + return "?", s, nil // trigraph workaround + case '\'', '"', '\\': + return string(r), s, nil + case '0', '1', '2', '3', '4', '5', '6', '7': + if len(s) < 2 { + return "", "", fmt.Errorf(`\%c requires 2 following digits`, r) + } + ss := string(r) + s[:2] + s = s[2:] + i, err := strconv.ParseUint(ss, 8, 8) + if err != nil { + return "", "", fmt.Errorf(`\%s contains non-octal digits`, ss) + } + return string([]byte{byte(i)}), s, nil + case 'x', 'X', 'u', 'U': + var n int + switch r { + case 'x', 'X': + n = 2 + case 'u': + n = 4 + case 'U': + n = 8 + } + if len(s) < n { + return "", "", fmt.Errorf(`\%c requires %d following digits`, r, n) + } + ss := s[:n] + s = s[n:] + i, err := strconv.ParseUint(ss, 16, 64) + if err != nil { + return "", "", fmt.Errorf(`\%c%s contains non-hexadecimal digits`, r, ss) + } + if r == 'x' || r == 'X' { + return string([]byte{byte(i)}), s, nil + } + if i > utf8.MaxRune { + return "", "", fmt.Errorf(`\%c%s is not a valid Unicode code point`, r, ss) + } + return string(i), s, nil + } + return "", "", fmt.Errorf(`unknown escape \%c`, r) +} + +// Back off the parser by one token. Can only be done between calls to next(). +// It makes the next advance() a no-op. +func (p *textParser) back() { p.backed = true } + +// Advances the parser and returns the new current token. +func (p *textParser) next() *token { + if p.backed || p.done { + p.backed = false + return &p.cur + } + p.advance() + if p.done { + p.cur.value = "" + } else if len(p.cur.value) > 0 && isQuote(p.cur.value[0]) { + // Look for multiple quoted strings separated by whitespace, + // and concatenate them. + cat := p.cur + for { + p.skipWhitespace() + if p.done || !isQuote(p.s[0]) { + break + } + p.advance() + if p.cur.err != nil { + return &p.cur + } + cat.value += " " + p.cur.value + cat.unquoted += p.cur.unquoted + } + p.done = false // parser may have seen EOF, but we want to return cat + p.cur = cat + } + return &p.cur +} + +func (p *textParser) consumeToken(s string) error { + tok := p.next() + if tok.err != nil { + return tok.err + } + if tok.value != s { + p.back() + return p.errorf("expected %q, found %q", s, tok.value) + } + return nil +} + +// Return a RequiredNotSetError indicating which required field was not set. +func (p *textParser) missingRequiredFieldError(sv reflect.Value) *RequiredNotSetError { + st := sv.Type() + sprops := GetProperties(st) + for i := 0; i < st.NumField(); i++ { + if !isNil(sv.Field(i)) { + continue + } + + props := sprops.Prop[i] + if props.Required { + return &RequiredNotSetError{fmt.Sprintf("%v.%v", st, props.OrigName)} + } + } + return &RequiredNotSetError{fmt.Sprintf("%v.", st)} // should not happen +} + +// Returns the index in the struct for the named field, as well as the parsed tag properties. +func structFieldByName(sprops *StructProperties, name string) (int, *Properties, bool) { + i, ok := sprops.decoderOrigNames[name] + if ok { + return i, sprops.Prop[i], true + } + return -1, nil, false +} + +// Consume a ':' from the input stream (if the next token is a colon), +// returning an error if a colon is needed but not present. +func (p *textParser) checkForColon(props *Properties, typ reflect.Type) *ParseError { + tok := p.next() + if tok.err != nil { + return tok.err + } + if tok.value != ":" { + // Colon is optional when the field is a group or message. + needColon := true + switch props.Wire { + case "group": + needColon = false + case "bytes": + // A "bytes" field is either a message, a string, or a repeated field; + // those three become *T, *string and []T respectively, so we can check for + // this field being a pointer to a non-string. + if typ.Kind() == reflect.Ptr { + // *T or *string + if typ.Elem().Kind() == reflect.String { + break + } + } else if typ.Kind() == reflect.Slice { + // []T or []*T + if typ.Elem().Kind() != reflect.Ptr { + break + } + } else if typ.Kind() == reflect.String { + // The proto3 exception is for a string field, + // which requires a colon. + break + } + needColon = false + } + if needColon { + return p.errorf("expected ':', found %q", tok.value) + } + p.back() + } + return nil +} + +func (p *textParser) readStruct(sv reflect.Value, terminator string) error { + st := sv.Type() + sprops := GetProperties(st) + reqCount := sprops.reqCount + var reqFieldErr error + fieldSet := make(map[string]bool) + // A struct is a sequence of "name: value", terminated by one of + // '>' or '}', or the end of the input. A name may also be + // "[extension]" or "[type/url]". + // + // The whole struct can also be an expanded Any message, like: + // [type/url] < ... struct contents ... > + for { + tok := p.next() + if tok.err != nil { + return tok.err + } + if tok.value == terminator { + break + } + if tok.value == "[" { + // Looks like an extension or an Any. + // + // TODO: Check whether we need to handle + // namespace rooted names (e.g. ".something.Foo"). + extName, err := p.consumeExtName() + if err != nil { + return err + } + + if s := strings.LastIndex(extName, "/"); s >= 0 { + // If it contains a slash, it's an Any type URL. + messageName := extName[s+1:] + mt := MessageType(messageName) + if mt == nil { + return p.errorf("unrecognized message %q in google.protobuf.Any", messageName) + } + tok = p.next() + if tok.err != nil { + return tok.err + } + // consume an optional colon + if tok.value == ":" { + tok = p.next() + if tok.err != nil { + return tok.err + } + } + var terminator string + switch tok.value { + case "<": + terminator = ">" + case "{": + terminator = "}" + default: + return p.errorf("expected '{' or '<', found %q", tok.value) + } + v := reflect.New(mt.Elem()) + if pe := p.readStruct(v.Elem(), terminator); pe != nil { + return pe + } + b, err := Marshal(v.Interface().(Message)) + if err != nil { + return p.errorf("failed to marshal message of type %q: %v", messageName, err) + } + if fieldSet["type_url"] { + return p.errorf(anyRepeatedlyUnpacked, "type_url") + } + if fieldSet["value"] { + return p.errorf(anyRepeatedlyUnpacked, "value") + } + sv.FieldByName("TypeUrl").SetString(extName) + sv.FieldByName("Value").SetBytes(b) + fieldSet["type_url"] = true + fieldSet["value"] = true + continue + } + + var desc *ExtensionDesc + // This could be faster, but it's functional. + // TODO: Do something smarter than a linear scan. + for _, d := range RegisteredExtensions(reflect.New(st).Interface().(Message)) { + if d.Name == extName { + desc = d + break + } + } + if desc == nil { + return p.errorf("unrecognized extension %q", extName) + } + + props := &Properties{} + props.Parse(desc.Tag) + + typ := reflect.TypeOf(desc.ExtensionType) + if err := p.checkForColon(props, typ); err != nil { + return err + } + + rep := desc.repeated() + + // Read the extension structure, and set it in + // the value we're constructing. + var ext reflect.Value + if !rep { + ext = reflect.New(typ).Elem() + } else { + ext = reflect.New(typ.Elem()).Elem() + } + if err := p.readAny(ext, props); err != nil { + if _, ok := err.(*RequiredNotSetError); !ok { + return err + } + reqFieldErr = err + } + ep := sv.Addr().Interface().(Message) + if !rep { + SetExtension(ep, desc, ext.Interface()) + } else { + old, err := GetExtension(ep, desc) + var sl reflect.Value + if err == nil { + sl = reflect.ValueOf(old) // existing slice + } else { + sl = reflect.MakeSlice(typ, 0, 1) + } + sl = reflect.Append(sl, ext) + SetExtension(ep, desc, sl.Interface()) + } + if err := p.consumeOptionalSeparator(); err != nil { + return err + } + continue + } + + // This is a normal, non-extension field. + name := tok.value + var dst reflect.Value + fi, props, ok := structFieldByName(sprops, name) + if ok { + dst = sv.Field(fi) + } else if oop, ok := sprops.OneofTypes[name]; ok { + // It is a oneof. + props = oop.Prop + nv := reflect.New(oop.Type.Elem()) + dst = nv.Elem().Field(0) + field := sv.Field(oop.Field) + if !field.IsNil() { + return p.errorf("field '%s' would overwrite already parsed oneof '%s'", name, sv.Type().Field(oop.Field).Name) + } + field.Set(nv) + } + if !dst.IsValid() { + return p.errorf("unknown field name %q in %v", name, st) + } + + if dst.Kind() == reflect.Map { + // Consume any colon. + if err := p.checkForColon(props, dst.Type()); err != nil { + return err + } + + // Construct the map if it doesn't already exist. + if dst.IsNil() { + dst.Set(reflect.MakeMap(dst.Type())) + } + key := reflect.New(dst.Type().Key()).Elem() + val := reflect.New(dst.Type().Elem()).Elem() + + // The map entry should be this sequence of tokens: + // < key : KEY value : VALUE > + // However, implementations may omit key or value, and technically + // we should support them in any order. See b/28924776 for a time + // this went wrong. + + tok := p.next() + var terminator string + switch tok.value { + case "<": + terminator = ">" + case "{": + terminator = "}" + default: + return p.errorf("expected '{' or '<', found %q", tok.value) + } + for { + tok := p.next() + if tok.err != nil { + return tok.err + } + if tok.value == terminator { + break + } + switch tok.value { + case "key": + if err := p.consumeToken(":"); err != nil { + return err + } + if err := p.readAny(key, props.mkeyprop); err != nil { + return err + } + if err := p.consumeOptionalSeparator(); err != nil { + return err + } + case "value": + if err := p.checkForColon(props.mvalprop, dst.Type().Elem()); err != nil { + return err + } + if err := p.readAny(val, props.mvalprop); err != nil { + return err + } + if err := p.consumeOptionalSeparator(); err != nil { + return err + } + default: + p.back() + return p.errorf(`expected "key", "value", or %q, found %q`, terminator, tok.value) + } + } + + dst.SetMapIndex(key, val) + continue + } + + // Check that it's not already set if it's not a repeated field. + if !props.Repeated && fieldSet[name] { + return p.errorf("non-repeated field %q was repeated", name) + } + + if err := p.checkForColon(props, dst.Type()); err != nil { + return err + } + + // Parse into the field. + fieldSet[name] = true + if err := p.readAny(dst, props); err != nil { + if _, ok := err.(*RequiredNotSetError); !ok { + return err + } + reqFieldErr = err + } + if props.Required { + reqCount-- + } + + if err := p.consumeOptionalSeparator(); err != nil { + return err + } + + } + + if reqCount > 0 { + return p.missingRequiredFieldError(sv) + } + return reqFieldErr +} + +// consumeExtName consumes extension name or expanded Any type URL and the +// following ']'. It returns the name or URL consumed. +func (p *textParser) consumeExtName() (string, error) { + tok := p.next() + if tok.err != nil { + return "", tok.err + } + + // If extension name or type url is quoted, it's a single token. + if len(tok.value) > 2 && isQuote(tok.value[0]) && tok.value[len(tok.value)-1] == tok.value[0] { + name, err := unquoteC(tok.value[1:len(tok.value)-1], rune(tok.value[0])) + if err != nil { + return "", err + } + return name, p.consumeToken("]") + } + + // Consume everything up to "]" + var parts []string + for tok.value != "]" { + parts = append(parts, tok.value) + tok = p.next() + if tok.err != nil { + return "", p.errorf("unrecognized type_url or extension name: %s", tok.err) + } + if p.done && tok.value != "]" { + return "", p.errorf("unclosed type_url or extension name") + } + } + return strings.Join(parts, ""), nil +} + +// consumeOptionalSeparator consumes an optional semicolon or comma. +// It is used in readStruct to provide backward compatibility. +func (p *textParser) consumeOptionalSeparator() error { + tok := p.next() + if tok.err != nil { + return tok.err + } + if tok.value != ";" && tok.value != "," { + p.back() + } + return nil +} + +func (p *textParser) readAny(v reflect.Value, props *Properties) error { + tok := p.next() + if tok.err != nil { + return tok.err + } + if tok.value == "" { + return p.errorf("unexpected EOF") + } + if len(props.CustomType) > 0 { + if props.Repeated { + t := reflect.TypeOf(v.Interface()) + if t.Kind() == reflect.Slice { + tc := reflect.TypeOf(new(Marshaler)) + ok := t.Elem().Implements(tc.Elem()) + if ok { + fv := v + flen := fv.Len() + if flen == fv.Cap() { + nav := reflect.MakeSlice(v.Type(), flen, 2*flen+1) + reflect.Copy(nav, fv) + fv.Set(nav) + } + fv.SetLen(flen + 1) + + // Read one. + p.back() + return p.readAny(fv.Index(flen), props) + } + } + } + if reflect.TypeOf(v.Interface()).Kind() == reflect.Ptr { + custom := reflect.New(props.ctype.Elem()).Interface().(Unmarshaler) + err := custom.Unmarshal([]byte(tok.unquoted)) + if err != nil { + return p.errorf("%v %v: %v", err, v.Type(), tok.value) + } + v.Set(reflect.ValueOf(custom)) + } else { + custom := reflect.New(reflect.TypeOf(v.Interface())).Interface().(Unmarshaler) + err := custom.Unmarshal([]byte(tok.unquoted)) + if err != nil { + return p.errorf("%v %v: %v", err, v.Type(), tok.value) + } + v.Set(reflect.Indirect(reflect.ValueOf(custom))) + } + return nil + } + if props.StdTime { + fv := v + p.back() + props.StdTime = false + tproto := ×tamp{} + err := p.readAny(reflect.ValueOf(tproto).Elem(), props) + props.StdTime = true + if err != nil { + return err + } + tim, err := timestampFromProto(tproto) + if err != nil { + return err + } + if props.Repeated { + t := reflect.TypeOf(v.Interface()) + if t.Kind() == reflect.Slice { + if t.Elem().Kind() == reflect.Ptr { + ts := fv.Interface().([]*time.Time) + ts = append(ts, &tim) + fv.Set(reflect.ValueOf(ts)) + return nil + } else { + ts := fv.Interface().([]time.Time) + ts = append(ts, tim) + fv.Set(reflect.ValueOf(ts)) + return nil + } + } + } + if reflect.TypeOf(v.Interface()).Kind() == reflect.Ptr { + v.Set(reflect.ValueOf(&tim)) + } else { + v.Set(reflect.Indirect(reflect.ValueOf(&tim))) + } + return nil + } + if props.StdDuration { + fv := v + p.back() + props.StdDuration = false + dproto := &duration{} + err := p.readAny(reflect.ValueOf(dproto).Elem(), props) + props.StdDuration = true + if err != nil { + return err + } + dur, err := durationFromProto(dproto) + if err != nil { + return err + } + if props.Repeated { + t := reflect.TypeOf(v.Interface()) + if t.Kind() == reflect.Slice { + if t.Elem().Kind() == reflect.Ptr { + ds := fv.Interface().([]*time.Duration) + ds = append(ds, &dur) + fv.Set(reflect.ValueOf(ds)) + return nil + } else { + ds := fv.Interface().([]time.Duration) + ds = append(ds, dur) + fv.Set(reflect.ValueOf(ds)) + return nil + } + } + } + if reflect.TypeOf(v.Interface()).Kind() == reflect.Ptr { + v.Set(reflect.ValueOf(&dur)) + } else { + v.Set(reflect.Indirect(reflect.ValueOf(&dur))) + } + return nil + } + switch fv := v; fv.Kind() { + case reflect.Slice: + at := v.Type() + if at.Elem().Kind() == reflect.Uint8 { + // Special case for []byte + if tok.value[0] != '"' && tok.value[0] != '\'' { + // Deliberately written out here, as the error after + // this switch statement would write "invalid []byte: ...", + // which is not as user-friendly. + return p.errorf("invalid string: %v", tok.value) + } + bytes := []byte(tok.unquoted) + fv.Set(reflect.ValueOf(bytes)) + return nil + } + // Repeated field. + if tok.value == "[" { + // Repeated field with list notation, like [1,2,3]. + for { + fv.Set(reflect.Append(fv, reflect.New(at.Elem()).Elem())) + err := p.readAny(fv.Index(fv.Len()-1), props) + if err != nil { + return err + } + ntok := p.next() + if ntok.err != nil { + return ntok.err + } + if ntok.value == "]" { + break + } + if ntok.value != "," { + return p.errorf("Expected ']' or ',' found %q", ntok.value) + } + } + return nil + } + // One value of the repeated field. + p.back() + fv.Set(reflect.Append(fv, reflect.New(at.Elem()).Elem())) + return p.readAny(fv.Index(fv.Len()-1), props) + case reflect.Bool: + // true/1/t/True or false/f/0/False. + switch tok.value { + case "true", "1", "t", "True": + fv.SetBool(true) + return nil + case "false", "0", "f", "False": + fv.SetBool(false) + return nil + } + case reflect.Float32, reflect.Float64: + v := tok.value + // Ignore 'f' for compatibility with output generated by C++, but don't + // remove 'f' when the value is "-inf" or "inf". + if strings.HasSuffix(v, "f") && tok.value != "-inf" && tok.value != "inf" { + v = v[:len(v)-1] + } + if f, err := strconv.ParseFloat(v, fv.Type().Bits()); err == nil { + fv.SetFloat(f) + return nil + } + case reflect.Int32: + if x, err := strconv.ParseInt(tok.value, 0, 32); err == nil { + fv.SetInt(x) + return nil + } + + if len(props.Enum) == 0 { + break + } + m, ok := enumValueMaps[props.Enum] + if !ok { + break + } + x, ok := m[tok.value] + if !ok { + break + } + fv.SetInt(int64(x)) + return nil + case reflect.Int64: + if x, err := strconv.ParseInt(tok.value, 0, 64); err == nil { + fv.SetInt(x) + return nil + } + + case reflect.Ptr: + // A basic field (indirected through pointer), or a repeated message/group + p.back() + fv.Set(reflect.New(fv.Type().Elem())) + return p.readAny(fv.Elem(), props) + case reflect.String: + if tok.value[0] == '"' || tok.value[0] == '\'' { + fv.SetString(tok.unquoted) + return nil + } + case reflect.Struct: + var terminator string + switch tok.value { + case "{": + terminator = "}" + case "<": + terminator = ">" + default: + return p.errorf("expected '{' or '<', found %q", tok.value) + } + // TODO: Handle nested messages which implement encoding.TextUnmarshaler. + return p.readStruct(fv, terminator) + case reflect.Uint32: + if x, err := strconv.ParseUint(tok.value, 0, 32); err == nil { + fv.SetUint(uint64(x)) + return nil + } + case reflect.Uint64: + if x, err := strconv.ParseUint(tok.value, 0, 64); err == nil { + fv.SetUint(x) + return nil + } + } + return p.errorf("invalid %v: %v", v.Type(), tok.value) +} + +// UnmarshalText reads a protocol buffer in Text format. UnmarshalText resets pb +// before starting to unmarshal, so any existing data in pb is always removed. +// If a required field is not set and no other error occurs, +// UnmarshalText returns *RequiredNotSetError. +func UnmarshalText(s string, pb Message) error { + if um, ok := pb.(encoding.TextUnmarshaler); ok { + return um.UnmarshalText([]byte(s)) + } + pb.Reset() + v := reflect.ValueOf(pb) + return newTextParser(s).readStruct(v.Elem(), "") +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/timestamp.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/timestamp.go new file mode 100644 index 000000000000..9324f6542bcf --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/timestamp.go @@ -0,0 +1,113 @@ +// Go support for Protocol Buffers - Google's data interchange format +// +// Copyright 2016 The Go Authors. All rights reserved. +// https://github.com/golang/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// * Neither the name of Google Inc. nor the names of its +// contributors may be used to endorse or promote products derived from +// this software without specific prior written permission. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +// This file implements operations on google.protobuf.Timestamp. + +import ( + "errors" + "fmt" + "time" +) + +const ( + // Seconds field of the earliest valid Timestamp. + // This is time.Date(1, 1, 1, 0, 0, 0, 0, time.UTC).Unix(). + minValidSeconds = -62135596800 + // Seconds field just after the latest valid Timestamp. + // This is time.Date(10000, 1, 1, 0, 0, 0, 0, time.UTC).Unix(). + maxValidSeconds = 253402300800 +) + +// validateTimestamp determines whether a Timestamp is valid. +// A valid timestamp represents a time in the range +// [0001-01-01, 10000-01-01) and has a Nanos field +// in the range [0, 1e9). +// +// If the Timestamp is valid, validateTimestamp returns nil. +// Otherwise, it returns an error that describes +// the problem. +// +// Every valid Timestamp can be represented by a time.Time, but the converse is not true. +func validateTimestamp(ts *timestamp) error { + if ts == nil { + return errors.New("timestamp: nil Timestamp") + } + if ts.Seconds < minValidSeconds { + return fmt.Errorf("timestamp: %#v before 0001-01-01", ts) + } + if ts.Seconds >= maxValidSeconds { + return fmt.Errorf("timestamp: %#v after 10000-01-01", ts) + } + if ts.Nanos < 0 || ts.Nanos >= 1e9 { + return fmt.Errorf("timestamp: %#v: nanos not in range [0, 1e9)", ts) + } + return nil +} + +// TimestampFromProto converts a google.protobuf.Timestamp proto to a time.Time. +// It returns an error if the argument is invalid. +// +// Unlike most Go functions, if Timestamp returns an error, the first return value +// is not the zero time.Time. Instead, it is the value obtained from the +// time.Unix function when passed the contents of the Timestamp, in the UTC +// locale. This may or may not be a meaningful time; many invalid Timestamps +// do map to valid time.Times. +// +// A nil Timestamp returns an error. The first return value in that case is +// undefined. +func timestampFromProto(ts *timestamp) (time.Time, error) { + // Don't return the zero value on error, because corresponds to a valid + // timestamp. Instead return whatever time.Unix gives us. + var t time.Time + if ts == nil { + t = time.Unix(0, 0).UTC() // treat nil like the empty Timestamp + } else { + t = time.Unix(ts.Seconds, int64(ts.Nanos)).UTC() + } + return t, validateTimestamp(ts) +} + +// TimestampProto converts the time.Time to a google.protobuf.Timestamp proto. +// It returns an error if the resulting Timestamp is invalid. +func timestampProto(t time.Time) (*timestamp, error) { + seconds := t.Unix() + nanos := int32(t.Sub(time.Unix(seconds, 0))) + ts := ×tamp{ + Seconds: seconds, + Nanos: nanos, + } + if err := validateTimestamp(ts); err != nil { + return nil, err + } + return ts, nil +} diff --git a/metricbeat/vendor/github.com/gogo/protobuf/proto/timestamp_gogo.go b/metricbeat/vendor/github.com/gogo/protobuf/proto/timestamp_gogo.go new file mode 100644 index 000000000000..38439fa99013 --- /dev/null +++ b/metricbeat/vendor/github.com/gogo/protobuf/proto/timestamp_gogo.go @@ -0,0 +1,49 @@ +// Protocol Buffers for Go with Gadgets +// +// Copyright (c) 2016, The GoGo Authors. All rights reserved. +// http://github.com/gogo/protobuf +// +// Redistribution and use in source and binary forms, with or without +// modification, are permitted provided that the following conditions are +// met: +// +// * Redistributions of source code must retain the above copyright +// notice, this list of conditions and the following disclaimer. +// * Redistributions in binary form must reproduce the above +// copyright notice, this list of conditions and the following disclaimer +// in the documentation and/or other materials provided with the +// distribution. +// +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + +package proto + +import ( + "reflect" + "time" +) + +var timeType = reflect.TypeOf((*time.Time)(nil)).Elem() + +type timestamp struct { + Seconds int64 `protobuf:"varint,1,opt,name=seconds,proto3" json:"seconds,omitempty"` + Nanos int32 `protobuf:"varint,2,opt,name=nanos,proto3" json:"nanos,omitempty"` +} + +func (m *timestamp) Reset() { *m = timestamp{} } +func (*timestamp) ProtoMessage() {} +func (*timestamp) String() string { return "timestamp" } + +func init() { + RegisterType((*timestamp)(nil), "gogo.protobuf.proto.timestamp") +} diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/LICENSE b/metricbeat/vendor/github.com/kubernetes/apimachinery/LICENSE new file mode 100644 index 000000000000..d64569567334 --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/LICENSE @@ -0,0 +1,202 @@ + + Apache License + Version 2.0, January 2004 + http://www.apache.org/licenses/ + + TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, + and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by + the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all + other entities that control, are controlled by, or are under common + control with that entity. For the purposes of this definition, + "control" means (i) the power, direct or indirect, to cause the + direction or management of such entity, whether by contract or + otherwise, or (ii) ownership of fifty percent (50%) or more of the + outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity + exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, + including but not limited to software source code, documentation + source, and configuration files. + + "Object" form shall mean any form resulting from mechanical + transformation or translation of a Source form, including but + not limited to compiled object code, generated documentation, + and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or + Object form, made available under the License, as indicated by a + copyright notice that is included in or attached to the work + (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object + form, that is based on (or derived from) the Work and for which the + editorial revisions, annotations, elaborations, or other modifications + represent, as a whole, an original work of authorship. For the purposes + of this License, Derivative Works shall not include works that remain + separable from, or merely link (or bind by name) to the interfaces of, + the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including + the original version of the Work and any modifications or additions + to that Work or Derivative Works thereof, that is intentionally + submitted to Licensor for inclusion in the Work by the copyright owner + or by an individual or Legal Entity authorized to submit on behalf of + the copyright owner. For the purposes of this definition, "submitted" + means any form of electronic, verbal, or written communication sent + to the Licensor or its representatives, including but not limited to + communication on electronic mailing lists, source code control systems, + and issue tracking systems that are managed by, or on behalf of, the + Licensor for the purpose of discussing and improving the Work, but + excluding communication that is conspicuously marked or otherwise + designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity + on behalf of whom a Contribution has been received by Licensor and + subsequently incorporated within the Work. + + 2. Grant of Copyright License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + copyright license to reproduce, prepare Derivative Works of, + publicly display, publicly perform, sublicense, and distribute the + Work and such Derivative Works in Source or Object form. + + 3. Grant of Patent License. Subject to the terms and conditions of + this License, each Contributor hereby grants to You a perpetual, + worldwide, non-exclusive, no-charge, royalty-free, irrevocable + (except as stated in this section) patent license to make, have made, + use, offer to sell, sell, import, and otherwise transfer the Work, + where such license applies only to those patent claims licensable + by such Contributor that are necessarily infringed by their + Contribution(s) alone or by combination of their Contribution(s) + with the Work to which such Contribution(s) was submitted. If You + institute patent litigation against any entity (including a + cross-claim or counterclaim in a lawsuit) alleging that the Work + or a Contribution incorporated within the Work constitutes direct + or contributory patent infringement, then any patent licenses + granted to You under this License for that Work shall terminate + as of the date such litigation is filed. + + 4. Redistribution. You may reproduce and distribute copies of the + Work or Derivative Works thereof in any medium, with or without + modifications, and in Source or Object form, provided that You + meet the following conditions: + + (a) You must give any other recipients of the Work or + Derivative Works a copy of this License; and + + (b) You must cause any modified files to carry prominent notices + stating that You changed the files; and + + (c) You must retain, in the Source form of any Derivative Works + that You distribute, all copyright, patent, trademark, and + attribution notices from the Source form of the Work, + excluding those notices that do not pertain to any part of + the Derivative Works; and + + (d) If the Work includes a "NOTICE" text file as part of its + distribution, then any Derivative Works that You distribute must + include a readable copy of the attribution notices contained + within such NOTICE file, excluding those notices that do not + pertain to any part of the Derivative Works, in at least one + of the following places: within a NOTICE text file distributed + as part of the Derivative Works; within the Source form or + documentation, if provided along with the Derivative Works; or, + within a display generated by the Derivative Works, if and + wherever such third-party notices normally appear. The contents + of the NOTICE file are for informational purposes only and + do not modify the License. You may add Your own attribution + notices within Derivative Works that You distribute, alongside + or as an addendum to the NOTICE text from the Work, provided + that such additional attribution notices cannot be construed + as modifying the License. + + You may add Your own copyright statement to Your modifications and + may provide additional or different license terms and conditions + for use, reproduction, or distribution of Your modifications, or + for any such Derivative Works as a whole, provided Your use, + reproduction, and distribution of the Work otherwise complies with + the conditions stated in this License. + + 5. Submission of Contributions. Unless You explicitly state otherwise, + any Contribution intentionally submitted for inclusion in the Work + by You to the Licensor shall be under the terms and conditions of + this License, without any additional terms or conditions. + Notwithstanding the above, nothing herein shall supersede or modify + the terms of any separate license agreement you may have executed + with Licensor regarding such Contributions. + + 6. Trademarks. This License does not grant permission to use the trade + names, trademarks, service marks, or product names of the Licensor, + except as required for reasonable and customary use in describing the + origin of the Work and reproducing the content of the NOTICE file. + + 7. Disclaimer of Warranty. Unless required by applicable law or + agreed to in writing, Licensor provides the Work (and each + Contributor provides its Contributions) on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or + implied, including, without limitation, any warranties or conditions + of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A + PARTICULAR PURPOSE. You are solely responsible for determining the + appropriateness of using or redistributing the Work and assume any + risks associated with Your exercise of permissions under this License. + + 8. Limitation of Liability. In no event and under no legal theory, + whether in tort (including negligence), contract, or otherwise, + unless required by applicable law (such as deliberate and grossly + negligent acts) or agreed to in writing, shall any Contributor be + liable to You for damages, including any direct, indirect, special, + incidental, or consequential damages of any character arising as a + result of this License or out of the use or inability to use the + Work (including but not limited to damages for loss of goodwill, + work stoppage, computer failure or malfunction, or any and all + other commercial damages or losses), even if such Contributor + has been advised of the possibility of such damages. + + 9. Accepting Warranty or Additional Liability. While redistributing + the Work or Derivative Works thereof, You may choose to offer, + and charge a fee for, acceptance of support, warranty, indemnity, + or other liability obligations and/or rights consistent with this + License. However, in accepting such obligations, You may act only + on Your own behalf and on Your sole responsibility, not on behalf + of any other Contributor, and only if You agree to indemnify, + defend, and hold each Contributor harmless for any liability + incurred by, or claims asserted against, such Contributor by reason + of your accepting any such warranty or additional liability. + + END OF TERMS AND CONDITIONS + + APPENDIX: How to apply the Apache License to your work. + + To apply the Apache License to your work, attach the following + boilerplate notice, with the fields enclosed by brackets "[]" + replaced with your own identifying information. (Don't include + the brackets!) The text should be enclosed in the appropriate + comment syntax for the file format. We also recommend that a + file or class name and description of purpose be included on the + same "printed page" as the copyright notice for easier + identification within third-party archives. + + Copyright [yyyy] [name of copyright owner] + + Licensed under the Apache License, Version 2.0 (the "License"); + you may not use this file except in compliance with the License. + You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/OWNERS b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/OWNERS new file mode 100755 index 000000000000..c430067f3573 --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/OWNERS @@ -0,0 +1,16 @@ +reviewers: +- thockin +- lavalamp +- smarterclayton +- wojtek-t +- derekwaynecarr +- mikedanese +- saad-ali +- janetkuo +- tallclair +- eparis +- jbeda +- xiang90 +- mbohlool +- david-mcmahon +- goltermann diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/amount.go b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/amount.go new file mode 100644 index 000000000000..a8866a43e10b --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/amount.go @@ -0,0 +1,299 @@ +/* +Copyright 2014 The Kubernetes Authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +*/ + +package resource + +import ( + "math/big" + "strconv" + + inf "gopkg.in/inf.v0" +) + +// Scale is used for getting and setting the base-10 scaled value. +// Base-2 scales are omitted for mathematical simplicity. +// See Quantity.ScaledValue for more details. +type Scale int32 + +// infScale adapts a Scale value to an inf.Scale value. +func (s Scale) infScale() inf.Scale { + return inf.Scale(-s) // inf.Scale is upside-down +} + +const ( + Nano Scale = -9 + Micro Scale = -6 + Milli Scale = -3 + Kilo Scale = 3 + Mega Scale = 6 + Giga Scale = 9 + Tera Scale = 12 + Peta Scale = 15 + Exa Scale = 18 +) + +var ( + Zero = int64Amount{} + + // Used by quantity strings - treat as read only + zeroBytes = []byte("0") +) + +// int64Amount represents a fixed precision numerator and arbitrary scale exponent. It is faster +// than operations on inf.Dec for values that can be represented as int64. +// +k8s:openapi-gen=true +type int64Amount struct { + value int64 + scale Scale +} + +// Sign returns 0 if the value is zero, -1 if it is less than 0, or 1 if it is greater than 0. +func (a int64Amount) Sign() int { + switch { + case a.value == 0: + return 0 + case a.value > 0: + return 1 + default: + return -1 + } +} + +// AsInt64 returns the current amount as an int64 at scale 0, or false if the value cannot be +// represented in an int64 OR would result in a loss of precision. This method is intended as +// an optimization to avoid calling AsDec. +func (a int64Amount) AsInt64() (int64, bool) { + if a.scale == 0 { + return a.value, true + } + if a.scale < 0 { + // TODO: attempt to reduce factors, although it is assumed that factors are reduced prior + // to the int64Amount being created. + return 0, false + } + return positiveScaleInt64(a.value, a.scale) +} + +// AsScaledInt64 returns an int64 representing the value of this amount at the specified scale, +// rounding up, or false if that would result in overflow. (1e20).AsScaledInt64(1) would result +// in overflow because 1e19 is not representable as an int64. Note that setting a scale larger +// than the current value may result in loss of precision - i.e. (1e-6).AsScaledInt64(0) would +// return 1, because 0.000001 is rounded up to 1. +func (a int64Amount) AsScaledInt64(scale Scale) (result int64, ok bool) { + if a.scale < scale { + result, _ = negativeScaleInt64(a.value, scale-a.scale) + return result, true + } + return positiveScaleInt64(a.value, a.scale-scale) +} + +// AsDec returns an inf.Dec representation of this value. +func (a int64Amount) AsDec() *inf.Dec { + var base inf.Dec + base.SetUnscaled(a.value) + base.SetScale(inf.Scale(-a.scale)) + return &base +} + +// Cmp returns 0 if a and b are equal, 1 if a is greater than b, or -1 if a is less than b. +func (a int64Amount) Cmp(b int64Amount) int { + switch { + case a.scale == b.scale: + // compare only the unscaled portion + case a.scale > b.scale: + result, remainder, exact := divideByScaleInt64(b.value, a.scale-b.scale) + if !exact { + return a.AsDec().Cmp(b.AsDec()) + } + if result == a.value { + switch { + case remainder == 0: + return 0 + case remainder > 0: + return -1 + default: + return 1 + } + } + b.value = result + default: + result, remainder, exact := divideByScaleInt64(a.value, b.scale-a.scale) + if !exact { + return a.AsDec().Cmp(b.AsDec()) + } + if result == b.value { + switch { + case remainder == 0: + return 0 + case remainder > 0: + return 1 + default: + return -1 + } + } + a.value = result + } + + switch { + case a.value == b.value: + return 0 + case a.value < b.value: + return -1 + default: + return 1 + } +} + +// Add adds two int64Amounts together, matching scales. It will return false and not mutate +// a if overflow or underflow would result. +func (a *int64Amount) Add(b int64Amount) bool { + switch { + case b.value == 0: + return true + case a.value == 0: + a.value = b.value + a.scale = b.scale + return true + case a.scale == b.scale: + c, ok := int64Add(a.value, b.value) + if !ok { + return false + } + a.value = c + case a.scale > b.scale: + c, ok := positiveScaleInt64(a.value, a.scale-b.scale) + if !ok { + return false + } + c, ok = int64Add(c, b.value) + if !ok { + return false + } + a.scale = b.scale + a.value = c + default: + c, ok := positiveScaleInt64(b.value, b.scale-a.scale) + if !ok { + return false + } + c, ok = int64Add(a.value, c) + if !ok { + return false + } + a.value = c + } + return true +} + +// Sub removes the value of b from the current amount, or returns false if underflow would result. +func (a *int64Amount) Sub(b int64Amount) bool { + return a.Add(int64Amount{value: -b.value, scale: b.scale}) +} + +// AsScale adjusts this amount to set a minimum scale, rounding up, and returns true iff no precision +// was lost. (1.1e5).AsScale(5) would return 1.1e5, but (1.1e5).AsScale(6) would return 1e6. +func (a int64Amount) AsScale(scale Scale) (int64Amount, bool) { + if a.scale >= scale { + return a, true + } + result, exact := negativeScaleInt64(a.value, scale-a.scale) + return int64Amount{value: result, scale: scale}, exact +} + +// AsCanonicalBytes accepts a buffer to write the base-10 string value of this field to, and returns +// either that buffer or a larger buffer and the current exponent of the value. The value is adjusted +// until the exponent is a multiple of 3 - i.e. 1.1e5 would return "110", 3. +func (a int64Amount) AsCanonicalBytes(out []byte) (result []byte, exponent int32) { + mantissa := a.value + exponent = int32(a.scale) + + amount, times := removeInt64Factors(mantissa, 10) + exponent += int32(times) + + // make sure exponent is a multiple of 3 + var ok bool + switch exponent % 3 { + case 1, -2: + amount, ok = int64MultiplyScale10(amount) + if !ok { + return infDecAmount{a.AsDec()}.AsCanonicalBytes(out) + } + exponent = exponent - 1 + case 2, -1: + amount, ok = int64MultiplyScale100(amount) + if !ok { + return infDecAmount{a.AsDec()}.AsCanonicalBytes(out) + } + exponent = exponent - 2 + } + return strconv.AppendInt(out, amount, 10), exponent +} + +// AsCanonicalBase1024Bytes accepts a buffer to write the base-1024 string value of this field to, and returns +// either that buffer or a larger buffer and the current exponent of the value. 2048 is 2 * 1024 ^ 1 and would +// return []byte("2048"), 1. +func (a int64Amount) AsCanonicalBase1024Bytes(out []byte) (result []byte, exponent int32) { + value, ok := a.AsScaledInt64(0) + if !ok { + return infDecAmount{a.AsDec()}.AsCanonicalBase1024Bytes(out) + } + amount, exponent := removeInt64Factors(value, 1024) + return strconv.AppendInt(out, amount, 10), exponent +} + +// infDecAmount implements common operations over an inf.Dec that are specific to the quantity +// representation. +type infDecAmount struct { + *inf.Dec +} + +// AsScale adjusts this amount to set a minimum scale, rounding up, and returns true iff no precision +// was lost. (1.1e5).AsScale(5) would return 1.1e5, but (1.1e5).AsScale(6) would return 1e6. +func (a infDecAmount) AsScale(scale Scale) (infDecAmount, bool) { + tmp := &inf.Dec{} + tmp.Round(a.Dec, scale.infScale(), inf.RoundUp) + return infDecAmount{tmp}, tmp.Cmp(a.Dec) == 0 +} + +// AsCanonicalBytes accepts a buffer to write the base-10 string value of this field to, and returns +// either that buffer or a larger buffer and the current exponent of the value. The value is adjusted +// until the exponent is a multiple of 3 - i.e. 1.1e5 would return "110", 3. +func (a infDecAmount) AsCanonicalBytes(out []byte) (result []byte, exponent int32) { + mantissa := a.Dec.UnscaledBig() + exponent = int32(-a.Dec.Scale()) + amount := big.NewInt(0).Set(mantissa) + // move all factors of 10 into the exponent for easy reasoning + amount, times := removeBigIntFactors(amount, bigTen) + exponent += times + + // make sure exponent is a multiple of 3 + for exponent%3 != 0 { + amount.Mul(amount, bigTen) + exponent-- + } + + return append(out, amount.String()...), exponent +} + +// AsCanonicalBase1024Bytes accepts a buffer to write the base-1024 string value of this field to, and returns +// either that buffer or a larger buffer and the current exponent of the value. 2048 is 2 * 1024 ^ 1 and would +// return []byte("2048"), 1. +func (a infDecAmount) AsCanonicalBase1024Bytes(out []byte) (result []byte, exponent int32) { + tmp := &inf.Dec{} + tmp.Round(a.Dec, 0, inf.RoundUp) + amount, exponent := removeBigIntFactors(tmp.UnscaledBig(), big1024) + return append(out, amount.String()...), exponent +} diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/generated.pb.go b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/generated.pb.go new file mode 100644 index 000000000000..083c82256b8e --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/generated.pb.go @@ -0,0 +1,77 @@ +/* +Copyright The Kubernetes Authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +*/ + +// Code generated by protoc-gen-gogo. +// source: k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/api/resource/generated.proto +// DO NOT EDIT! + +/* + Package resource is a generated protocol buffer package. + + It is generated from these files: + k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/api/resource/generated.proto + + It has these top-level messages: + Quantity +*/ +package resource + +import proto "github.com/gogo/protobuf/proto" +import fmt "fmt" +import math "math" + +// Reference imports to suppress errors if they are not otherwise used. +var _ = proto.Marshal +var _ = fmt.Errorf +var _ = math.Inf + +// This is a compile-time assertion to ensure that this generated file +// is compatible with the proto package it is being compiled against. +// A compilation error at this line likely means your copy of the +// proto package needs to be updated. +const _ = proto.GoGoProtoPackageIsVersion2 // please upgrade the proto package + +func (m *Quantity) Reset() { *m = Quantity{} } +func (*Quantity) ProtoMessage() {} +func (*Quantity) Descriptor() ([]byte, []int) { return fileDescriptorGenerated, []int{0} } + +func init() { + proto.RegisterType((*Quantity)(nil), "k8s.io.apimachinery.pkg.api.resource.Quantity") +} + +func init() { + proto.RegisterFile("k8s.io/kubernetes/vendor/k8s.io/apimachinery/pkg/api/resource/generated.proto", fileDescriptorGenerated) +} + +var fileDescriptorGenerated = []byte{ + // 255 bytes of a gzipped FileDescriptorProto + 0x1f, 0x8b, 0x08, 0x00, 0x00, 0x00, 0x00, 0x00, 0x02, 0xff, 0x74, 0x8f, 0xa1, 0x4e, 0x03, 0x41, + 0x10, 0x86, 0x77, 0x0d, 0x29, 0x95, 0x0d, 0x21, 0xa4, 0x62, 0xaf, 0x21, 0x08, 0x0c, 0x3b, 0x02, + 0xd3, 0x20, 0xf1, 0x08, 0x90, 0xb8, 0xbb, 0xeb, 0xb0, 0xdd, 0x1c, 0xdd, 0xbd, 0xcc, 0xce, 0x92, + 0xd4, 0x55, 0x22, 0x2b, 0x91, 0xbd, 0xb7, 0xa9, 0xac, 0xac, 0x40, 0x70, 0xcb, 0x8b, 0x90, 0x5e, + 0xdb, 0x84, 0x90, 0xe0, 0xe6, 0xfb, 0x27, 0xdf, 0xe4, 0x9f, 0xfe, 0x43, 0x35, 0x0e, 0xda, 0x7a, + 0xa8, 0x62, 0x81, 0xe4, 0x90, 0x31, 0xc0, 0x1b, 0xba, 0x89, 0x27, 0x38, 0x2c, 0xf2, 0xda, 0xce, + 0xf2, 0x72, 0x6a, 0x1d, 0xd2, 0x1c, 0xea, 0xca, 0xec, 0x02, 0x20, 0x0c, 0x3e, 0x52, 0x89, 0x60, + 0xd0, 0x21, 0xe5, 0x8c, 0x13, 0x5d, 0x93, 0x67, 0x3f, 0xb8, 0xda, 0x5b, 0xfa, 0xb7, 0xa5, 0xeb, + 0xca, 0xec, 0x02, 0x7d, 0xb4, 0x86, 0x37, 0xc6, 0xf2, 0x34, 0x16, 0xba, 0xf4, 0x33, 0x30, 0xde, + 0x78, 0xe8, 0xe4, 0x22, 0xbe, 0x74, 0xd4, 0x41, 0x37, 0xed, 0x8f, 0x0e, 0x6f, 0xff, 0xab, 0x12, + 0xd9, 0xbe, 0x82, 0x75, 0x1c, 0x98, 0xfe, 0x36, 0xb9, 0x1c, 0xf7, 0x7b, 0x8f, 0x31, 0x77, 0x6c, + 0x79, 0x3e, 0x38, 0xef, 0x9f, 0x04, 0x26, 0xeb, 0xcc, 0x85, 0x1c, 0xc9, 0xeb, 0xd3, 0xa7, 0x03, + 0xdd, 0x9d, 0x7d, 0xac, 0x32, 0xf1, 0xde, 0x64, 0x62, 0xd9, 0x64, 0x62, 0xd5, 0x64, 0x62, 0xf1, + 0x39, 0x12, 0xf7, 0x7a, 0xdd, 0x2a, 0xb1, 0x69, 0x95, 0xd8, 0xb6, 0x4a, 0x2c, 0x92, 0x92, 0xeb, + 0xa4, 0xe4, 0x26, 0x29, 0xb9, 0x4d, 0x4a, 0x7e, 0x25, 0x25, 0x97, 0xdf, 0x4a, 0x3c, 0xf7, 0x8e, + 0xdf, 0xfc, 0x04, 0x00, 0x00, 0xff, 0xff, 0x5f, 0x5e, 0xda, 0xf9, 0x43, 0x01, 0x00, 0x00, +} diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/generated.proto b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/generated.proto new file mode 100644 index 000000000000..31a46a6d30eb --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/generated.proto @@ -0,0 +1,95 @@ +/* +Copyright The Kubernetes Authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +*/ + + +// This file was autogenerated by go-to-protobuf. Do not edit it manually! + +syntax = 'proto2'; + +package k8s.io.apimachinery.pkg.api.resource; + +import "k8s.io/apimachinery/pkg/util/intstr/generated.proto"; + +// Package-wide variables from generator "generated". +option go_package = "resource"; + +// Quantity is a fixed-point representation of a number. +// It provides convenient marshaling/unmarshaling in JSON and YAML, +// in addition to String() and Int64() accessors. +// +// The serialization format is: +// +// ::= +// (Note that may be empty, from the "" case in .) +// ::= 0 | 1 | ... | 9 +// ::= | +// ::= | . | . | . +// ::= "+" | "-" +// ::= | +// ::= | | +// ::= Ki | Mi | Gi | Ti | Pi | Ei +// (International System of units; See: http://physics.nist.gov/cuu/Units/binary.html) +// ::= m | "" | k | M | G | T | P | E +// (Note that 1024 = 1Ki but 1000 = 1k; I didn't choose the capitalization.) +// ::= "e" | "E" +// +// No matter which of the three exponent forms is used, no quantity may represent +// a number greater than 2^63-1 in magnitude, nor may it have more than 3 decimal +// places. Numbers larger or more precise will be capped or rounded up. +// (E.g.: 0.1m will rounded up to 1m.) +// This may be extended in the future if we require larger or smaller quantities. +// +// When a Quantity is parsed from a string, it will remember the type of suffix +// it had, and will use the same type again when it is serialized. +// +// Before serializing, Quantity will be put in "canonical form". +// This means that Exponent/suffix will be adjusted up or down (with a +// corresponding increase or decrease in Mantissa) such that: +// a. No precision is lost +// b. No fractional digits will be emitted +// c. The exponent (or suffix) is as large as possible. +// The sign will be omitted unless the number is negative. +// +// Examples: +// 1.5 will be serialized as "1500m" +// 1.5Gi will be serialized as "1536Mi" +// +// NOTE: We reserve the right to amend this canonical format, perhaps to +// allow 1.5 to be canonical. +// TODO: Remove above disclaimer after all bikeshedding about format is over, +// or after March 2015. +// +// Note that the quantity will NEVER be internally represented by a +// floating point number. That is the whole point of this exercise. +// +// Non-canonical values will still parse as long as they are well formed, +// but will be re-emitted in their canonical form. (So always use canonical +// form, or don't diff.) +// +// This format is intended to make it difficult to use these numbers without +// writing some sort of special handling code in the hopes that that will +// cause implementors to also use a fixed point implementation. +// +// +protobuf=true +// +protobuf.embed=string +// +protobuf.options.marshal=false +// +protobuf.options.(gogoproto.goproto_stringer)=false +// +k8s:deepcopy-gen=true +// +k8s:openapi-gen=true +message Quantity { + optional string string = 1; +} + diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/math.go b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/math.go new file mode 100644 index 000000000000..72d3880c0281 --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/math.go @@ -0,0 +1,314 @@ +/* +Copyright 2014 The Kubernetes Authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +*/ + +package resource + +import ( + "math/big" + + inf "gopkg.in/inf.v0" +) + +const ( + // maxInt64Factors is the highest value that will be checked when removing factors of 10 from an int64. + // It is also the maximum decimal digits that can be represented with an int64. + maxInt64Factors = 18 +) + +var ( + // Commonly needed big.Int values-- treat as read only! + bigTen = big.NewInt(10) + bigZero = big.NewInt(0) + bigOne = big.NewInt(1) + bigThousand = big.NewInt(1000) + big1024 = big.NewInt(1024) + + // Commonly needed inf.Dec values-- treat as read only! + decZero = inf.NewDec(0, 0) + decOne = inf.NewDec(1, 0) + decMinusOne = inf.NewDec(-1, 0) + decThousand = inf.NewDec(1000, 0) + dec1024 = inf.NewDec(1024, 0) + decMinus1024 = inf.NewDec(-1024, 0) + + // Largest (in magnitude) number allowed. + maxAllowed = infDecAmount{inf.NewDec((1<<63)-1, 0)} // == max int64 + + // The maximum value we can represent milli-units for. + // Compare with the return value of Quantity.Value() to + // see if it's safe to use Quantity.MilliValue(). + MaxMilliValue = int64(((1 << 63) - 1) / 1000) +) + +const mostNegative = -(mostPositive + 1) +const mostPositive = 1<<63 - 1 + +// int64Add returns a+b, or false if that would overflow int64. +func int64Add(a, b int64) (int64, bool) { + c := a + b + switch { + case a > 0 && b > 0: + if c < 0 { + return 0, false + } + case a < 0 && b < 0: + if c > 0 { + return 0, false + } + if a == mostNegative && b == mostNegative { + return 0, false + } + } + return c, true +} + +// int64Multiply returns a*b, or false if that would overflow or underflow int64. +func int64Multiply(a, b int64) (int64, bool) { + if a == 0 || b == 0 || a == 1 || b == 1 { + return a * b, true + } + if a == mostNegative || b == mostNegative { + return 0, false + } + c := a * b + return c, c/b == a +} + +// int64MultiplyScale returns a*b, assuming b is greater than one, or false if that would overflow or underflow int64. +// Use when b is known to be greater than one. +func int64MultiplyScale(a int64, b int64) (int64, bool) { + if a == 0 || a == 1 { + return a * b, true + } + if a == mostNegative && b != 1 { + return 0, false + } + c := a * b + return c, c/b == a +} + +// int64MultiplyScale10 multiplies a by 10, or returns false if that would overflow. This method is faster than +// int64Multiply(a, 10) because the compiler can optimize constant factor multiplication. +func int64MultiplyScale10(a int64) (int64, bool) { + if a == 0 || a == 1 { + return a * 10, true + } + if a == mostNegative { + return 0, false + } + c := a * 10 + return c, c/10 == a +} + +// int64MultiplyScale100 multiplies a by 100, or returns false if that would overflow. This method is faster than +// int64Multiply(a, 100) because the compiler can optimize constant factor multiplication. +func int64MultiplyScale100(a int64) (int64, bool) { + if a == 0 || a == 1 { + return a * 100, true + } + if a == mostNegative { + return 0, false + } + c := a * 100 + return c, c/100 == a +} + +// int64MultiplyScale1000 multiplies a by 1000, or returns false if that would overflow. This method is faster than +// int64Multiply(a, 1000) because the compiler can optimize constant factor multiplication. +func int64MultiplyScale1000(a int64) (int64, bool) { + if a == 0 || a == 1 { + return a * 1000, true + } + if a == mostNegative { + return 0, false + } + c := a * 1000 + return c, c/1000 == a +} + +// positiveScaleInt64 multiplies base by 10^scale, returning false if the +// value overflows. Passing a negative scale is undefined. +func positiveScaleInt64(base int64, scale Scale) (int64, bool) { + switch scale { + case 0: + return base, true + case 1: + return int64MultiplyScale10(base) + case 2: + return int64MultiplyScale100(base) + case 3: + return int64MultiplyScale1000(base) + case 6: + return int64MultiplyScale(base, 1000000) + case 9: + return int64MultiplyScale(base, 1000000000) + default: + value := base + var ok bool + for i := Scale(0); i < scale; i++ { + if value, ok = int64MultiplyScale(value, 10); !ok { + return 0, false + } + } + return value, true + } +} + +// negativeScaleInt64 reduces base by the provided scale, rounding up, until the +// value is zero or the scale is reached. Passing a negative scale is undefined. +// The value returned, if not exact, is rounded away from zero. +func negativeScaleInt64(base int64, scale Scale) (result int64, exact bool) { + if scale == 0 { + return base, true + } + + value := base + var fraction bool + for i := Scale(0); i < scale; i++ { + if !fraction && value%10 != 0 { + fraction = true + } + value = value / 10 + if value == 0 { + if fraction { + if base > 0 { + return 1, false + } + return -1, false + } + return 0, true + } + } + if fraction { + if base > 0 { + value += 1 + } else { + value += -1 + } + } + return value, !fraction +} + +func pow10Int64(b int64) int64 { + switch b { + case 0: + return 1 + case 1: + return 10 + case 2: + return 100 + case 3: + return 1000 + case 4: + return 10000 + case 5: + return 100000 + case 6: + return 1000000 + case 7: + return 10000000 + case 8: + return 100000000 + case 9: + return 1000000000 + case 10: + return 10000000000 + case 11: + return 100000000000 + case 12: + return 1000000000000 + case 13: + return 10000000000000 + case 14: + return 100000000000000 + case 15: + return 1000000000000000 + case 16: + return 10000000000000000 + case 17: + return 100000000000000000 + case 18: + return 1000000000000000000 + default: + return 0 + } +} + +// negativeScaleInt64 returns the result of dividing base by scale * 10 and the remainder, or +// false if no such division is possible. Dividing by negative scales is undefined. +func divideByScaleInt64(base int64, scale Scale) (result, remainder int64, exact bool) { + if scale == 0 { + return base, 0, true + } + // the max scale representable in base 10 in an int64 is 18 decimal places + if scale >= 18 { + return 0, base, false + } + divisor := pow10Int64(int64(scale)) + return base / divisor, base % divisor, true +} + +// removeInt64Factors divides in a loop; the return values have the property that +// value == result * base ^ scale +func removeInt64Factors(value int64, base int64) (result int64, times int32) { + times = 0 + result = value + negative := result < 0 + if negative { + result = -result + } + switch base { + // allow the compiler to optimize the common cases + case 10: + for result >= 10 && result%10 == 0 { + times++ + result = result / 10 + } + // allow the compiler to optimize the common cases + case 1024: + for result >= 1024 && result%1024 == 0 { + times++ + result = result / 1024 + } + default: + for result >= base && result%base == 0 { + times++ + result = result / base + } + } + if negative { + result = -result + } + return result, times +} + +// removeBigIntFactors divides in a loop; the return values have the property that +// d == result * factor ^ times +// d may be modified in place. +// If d == 0, then the return values will be (0, 0) +func removeBigIntFactors(d, factor *big.Int) (result *big.Int, times int32) { + q := big.NewInt(0) + m := big.NewInt(0) + for d.Cmp(bigZero) != 0 { + q.DivMod(d, factor, m) + if m.Cmp(bigZero) != 0 { + break + } + times++ + d, q = q, d + } + return d, times +} diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/quantity.go b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/quantity.go new file mode 100644 index 000000000000..c3cd139607e9 --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/quantity.go @@ -0,0 +1,747 @@ +/* +Copyright 2014 The Kubernetes Authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +*/ + +package resource + +import ( + "bytes" + "errors" + "fmt" + "math/big" + "regexp" + "strconv" + "strings" + + inf "gopkg.in/inf.v0" +) + +// Quantity is a fixed-point representation of a number. +// It provides convenient marshaling/unmarshaling in JSON and YAML, +// in addition to String() and Int64() accessors. +// +// The serialization format is: +// +// ::= +// (Note that may be empty, from the "" case in .) +// ::= 0 | 1 | ... | 9 +// ::= | +// ::= | . | . | . +// ::= "+" | "-" +// ::= | +// ::= | | +// ::= Ki | Mi | Gi | Ti | Pi | Ei +// (International System of units; See: http://physics.nist.gov/cuu/Units/binary.html) +// ::= m | "" | k | M | G | T | P | E +// (Note that 1024 = 1Ki but 1000 = 1k; I didn't choose the capitalization.) +// ::= "e" | "E" +// +// No matter which of the three exponent forms is used, no quantity may represent +// a number greater than 2^63-1 in magnitude, nor may it have more than 3 decimal +// places. Numbers larger or more precise will be capped or rounded up. +// (E.g.: 0.1m will rounded up to 1m.) +// This may be extended in the future if we require larger or smaller quantities. +// +// When a Quantity is parsed from a string, it will remember the type of suffix +// it had, and will use the same type again when it is serialized. +// +// Before serializing, Quantity will be put in "canonical form". +// This means that Exponent/suffix will be adjusted up or down (with a +// corresponding increase or decrease in Mantissa) such that: +// a. No precision is lost +// b. No fractional digits will be emitted +// c. The exponent (or suffix) is as large as possible. +// The sign will be omitted unless the number is negative. +// +// Examples: +// 1.5 will be serialized as "1500m" +// 1.5Gi will be serialized as "1536Mi" +// +// NOTE: We reserve the right to amend this canonical format, perhaps to +// allow 1.5 to be canonical. +// TODO: Remove above disclaimer after all bikeshedding about format is over, +// or after March 2015. +// +// Note that the quantity will NEVER be internally represented by a +// floating point number. That is the whole point of this exercise. +// +// Non-canonical values will still parse as long as they are well formed, +// but will be re-emitted in their canonical form. (So always use canonical +// form, or don't diff.) +// +// This format is intended to make it difficult to use these numbers without +// writing some sort of special handling code in the hopes that that will +// cause implementors to also use a fixed point implementation. +// +// +protobuf=true +// +protobuf.embed=string +// +protobuf.options.marshal=false +// +protobuf.options.(gogoproto.goproto_stringer)=false +// +k8s:deepcopy-gen=true +// +k8s:openapi-gen=true +type Quantity struct { + // i is the quantity in int64 scaled form, if d.Dec == nil + i int64Amount + // d is the quantity in inf.Dec form if d.Dec != nil + d infDecAmount + // s is the generated value of this quantity to avoid recalculation + s string + + // Change Format at will. See the comment for Canonicalize for + // more details. + Format +} + +// CanonicalValue allows a quantity amount to be converted to a string. +type CanonicalValue interface { + // AsCanonicalBytes returns a byte array representing the string representation + // of the value mantissa and an int32 representing its exponent in base-10. Callers may + // pass a byte slice to the method to avoid allocations. + AsCanonicalBytes(out []byte) ([]byte, int32) + // AsCanonicalBase1024Bytes returns a byte array representing the string representation + // of the value mantissa and an int32 representing its exponent in base-1024. Callers + // may pass a byte slice to the method to avoid allocations. + AsCanonicalBase1024Bytes(out []byte) ([]byte, int32) +} + +// Format lists the three possible formattings of a quantity. +type Format string + +const ( + DecimalExponent = Format("DecimalExponent") // e.g., 12e6 + BinarySI = Format("BinarySI") // e.g., 12Mi (12 * 2^20) + DecimalSI = Format("DecimalSI") // e.g., 12M (12 * 10^6) +) + +// MustParse turns the given string into a quantity or panics; for tests +// or others cases where you know the string is valid. +func MustParse(str string) Quantity { + q, err := ParseQuantity(str) + if err != nil { + panic(fmt.Errorf("cannot parse '%v': %v", str, err)) + } + return q +} + +const ( + // splitREString is used to separate a number from its suffix; as such, + // this is overly permissive, but that's OK-- it will be checked later. + splitREString = "^([+-]?[0-9.]+)([eEinumkKMGTP]*[-+]?[0-9]*)$" +) + +var ( + // splitRE is used to get the various parts of a number. + splitRE = regexp.MustCompile(splitREString) + + // Errors that could happen while parsing a string. + ErrFormatWrong = errors.New("quantities must match the regular expression '" + splitREString + "'") + ErrNumeric = errors.New("unable to parse numeric part of quantity") + ErrSuffix = errors.New("unable to parse quantity's suffix") +) + +// parseQuantityString is a fast scanner for quantity values. +func parseQuantityString(str string) (positive bool, value, num, denom, suffix string, err error) { + positive = true + pos := 0 + end := len(str) + + // handle leading sign + if pos < end { + switch str[0] { + case '-': + positive = false + pos++ + case '+': + pos++ + } + } + + // strip leading zeros +Zeroes: + for i := pos; ; i++ { + if i >= end { + num = "0" + value = num + return + } + switch str[i] { + case '0': + pos++ + default: + break Zeroes + } + } + + // extract the numerator +Num: + for i := pos; ; i++ { + if i >= end { + num = str[pos:end] + value = str[0:end] + return + } + switch str[i] { + case '0', '1', '2', '3', '4', '5', '6', '7', '8', '9': + default: + num = str[pos:i] + pos = i + break Num + } + } + + // if we stripped all numerator positions, always return 0 + if len(num) == 0 { + num = "0" + } + + // handle a denominator + if pos < end && str[pos] == '.' { + pos++ + Denom: + for i := pos; ; i++ { + if i >= end { + denom = str[pos:end] + value = str[0:end] + return + } + switch str[i] { + case '0', '1', '2', '3', '4', '5', '6', '7', '8', '9': + default: + denom = str[pos:i] + pos = i + break Denom + } + } + // TODO: we currently allow 1.G, but we may not want to in the future. + // if len(denom) == 0 { + // err = ErrFormatWrong + // return + // } + } + value = str[0:pos] + + // grab the elements of the suffix + suffixStart := pos + for i := pos; ; i++ { + if i >= end { + suffix = str[suffixStart:end] + return + } + if !strings.ContainsAny(str[i:i+1], "eEinumkKMGTP") { + pos = i + break + } + } + if pos < end { + switch str[pos] { + case '-', '+': + pos++ + } + } +Suffix: + for i := pos; ; i++ { + if i >= end { + suffix = str[suffixStart:end] + return + } + switch str[i] { + case '0', '1', '2', '3', '4', '5', '6', '7', '8', '9': + default: + break Suffix + } + } + // we encountered a non decimal in the Suffix loop, but the last character + // was not a valid exponent + err = ErrFormatWrong + return +} + +// ParseQuantity turns str into a Quantity, or returns an error. +func ParseQuantity(str string) (Quantity, error) { + if len(str) == 0 { + return Quantity{}, ErrFormatWrong + } + if str == "0" { + return Quantity{Format: DecimalSI, s: str}, nil + } + + positive, value, num, denom, suf, err := parseQuantityString(str) + if err != nil { + return Quantity{}, err + } + + base, exponent, format, ok := quantitySuffixer.interpret(suffix(suf)) + if !ok { + return Quantity{}, ErrSuffix + } + + precision := int32(0) + scale := int32(0) + mantissa := int64(1) + switch format { + case DecimalExponent, DecimalSI: + scale = exponent + precision = maxInt64Factors - int32(len(num)+len(denom)) + case BinarySI: + scale = 0 + switch { + case exponent >= 0 && len(denom) == 0: + // only handle positive binary numbers with the fast path + mantissa = int64(int64(mantissa) << uint64(exponent)) + // 1Mi (2^20) has ~6 digits of decimal precision, so exponent*3/10 -1 is roughly the precision + precision = 15 - int32(len(num)) - int32(float32(exponent)*3/10) - 1 + default: + precision = -1 + } + } + + if precision >= 0 { + // if we have a denominator, shift the entire value to the left by the number of places in the + // denominator + scale -= int32(len(denom)) + if scale >= int32(Nano) { + shifted := num + denom + + var value int64 + value, err := strconv.ParseInt(shifted, 10, 64) + if err != nil { + return Quantity{}, ErrNumeric + } + if result, ok := int64Multiply(value, int64(mantissa)); ok { + if !positive { + result = -result + } + // if the number is in canonical form, reuse the string + switch format { + case BinarySI: + if exponent%10 == 0 && (value&0x07 != 0) { + return Quantity{i: int64Amount{value: result, scale: Scale(scale)}, Format: format, s: str}, nil + } + default: + if scale%3 == 0 && !strings.HasSuffix(shifted, "000") && shifted[0] != '0' { + return Quantity{i: int64Amount{value: result, scale: Scale(scale)}, Format: format, s: str}, nil + } + } + return Quantity{i: int64Amount{value: result, scale: Scale(scale)}, Format: format}, nil + } + } + } + + amount := new(inf.Dec) + if _, ok := amount.SetString(value); !ok { + return Quantity{}, ErrNumeric + } + + // So that no one but us has to think about suffixes, remove it. + if base == 10 { + amount.SetScale(amount.Scale() + Scale(exponent).infScale()) + } else if base == 2 { + // numericSuffix = 2 ** exponent + numericSuffix := big.NewInt(1).Lsh(bigOne, uint(exponent)) + ub := amount.UnscaledBig() + amount.SetUnscaledBig(ub.Mul(ub, numericSuffix)) + } + + // Cap at min/max bounds. + sign := amount.Sign() + if sign == -1 { + amount.Neg(amount) + } + + // This rounds non-zero values up to the minimum representable value, under the theory that + // if you want some resources, you should get some resources, even if you asked for way too small + // of an amount. Arguably, this should be inf.RoundHalfUp (normal rounding), but that would have + // the side effect of rounding values < .5n to zero. + if v, ok := amount.Unscaled(); v != int64(0) || !ok { + amount.Round(amount, Nano.infScale(), inf.RoundUp) + } + + // The max is just a simple cap. + // TODO: this prevents accumulating quantities greater than int64, for instance quota across a cluster + if format == BinarySI && amount.Cmp(maxAllowed.Dec) > 0 { + amount.Set(maxAllowed.Dec) + } + + if format == BinarySI && amount.Cmp(decOne) < 0 && amount.Cmp(decZero) > 0 { + // This avoids rounding and hopefully confusion, too. + format = DecimalSI + } + if sign == -1 { + amount.Neg(amount) + } + + return Quantity{d: infDecAmount{amount}, Format: format}, nil +} + +// DeepCopy returns a deep-copy of the Quantity value. Note that the method +// receiver is a value, so we can mutate it in-place and return it. +func (q Quantity) DeepCopy() Quantity { + if q.d.Dec != nil { + tmp := &inf.Dec{} + q.d.Dec = tmp.Set(q.d.Dec) + } + return q +} + +// OpenAPISchemaType is used by the kube-openapi generator when constructing +// the OpenAPI spec of this type. +// +// See: https://github.com/kubernetes/kube-openapi/tree/master/pkg/generators +func (_ Quantity) OpenAPISchemaType() []string { return []string{"string"} } + +// OpenAPISchemaFormat is used by the kube-openapi generator when constructing +// the OpenAPI spec of this type. +func (_ Quantity) OpenAPISchemaFormat() string { return "" } + +// CanonicalizeBytes returns the canonical form of q and its suffix (see comment on Quantity). +// +// Note about BinarySI: +// * If q.Format is set to BinarySI and q.Amount represents a non-zero value between +// -1 and +1, it will be emitted as if q.Format were DecimalSI. +// * Otherwise, if q.Format is set to BinarySI, fractional parts of q.Amount will be +// rounded up. (1.1i becomes 2i.) +func (q *Quantity) CanonicalizeBytes(out []byte) (result, suffix []byte) { + if q.IsZero() { + return zeroBytes, nil + } + + var rounded CanonicalValue + format := q.Format + switch format { + case DecimalExponent, DecimalSI: + case BinarySI: + if q.CmpInt64(-1024) > 0 && q.CmpInt64(1024) < 0 { + // This avoids rounding and hopefully confusion, too. + format = DecimalSI + } else { + var exact bool + if rounded, exact = q.AsScale(0); !exact { + // Don't lose precision-- show as DecimalSI + format = DecimalSI + } + } + default: + format = DecimalExponent + } + + // TODO: If BinarySI formatting is requested but would cause rounding, upgrade to + // one of the other formats. + switch format { + case DecimalExponent, DecimalSI: + number, exponent := q.AsCanonicalBytes(out) + suffix, _ := quantitySuffixer.constructBytes(10, exponent, format) + return number, suffix + default: + // format must be BinarySI + number, exponent := rounded.AsCanonicalBase1024Bytes(out) + suffix, _ := quantitySuffixer.constructBytes(2, exponent*10, format) + return number, suffix + } +} + +// AsInt64 returns a representation of the current value as an int64 if a fast conversion +// is possible. If false is returned, callers must use the inf.Dec form of this quantity. +func (q *Quantity) AsInt64() (int64, bool) { + if q.d.Dec != nil { + return 0, false + } + return q.i.AsInt64() +} + +// ToDec promotes the quantity in place to use an inf.Dec representation and returns itself. +func (q *Quantity) ToDec() *Quantity { + if q.d.Dec == nil { + q.d.Dec = q.i.AsDec() + q.i = int64Amount{} + } + return q +} + +// AsDec returns the quantity as represented by a scaled inf.Dec. +func (q *Quantity) AsDec() *inf.Dec { + if q.d.Dec != nil { + return q.d.Dec + } + q.d.Dec = q.i.AsDec() + q.i = int64Amount{} + return q.d.Dec +} + +// AsCanonicalBytes returns the canonical byte representation of this quantity as a mantissa +// and base 10 exponent. The out byte slice may be passed to the method to avoid an extra +// allocation. +func (q *Quantity) AsCanonicalBytes(out []byte) (result []byte, exponent int32) { + if q.d.Dec != nil { + return q.d.AsCanonicalBytes(out) + } + return q.i.AsCanonicalBytes(out) +} + +// IsZero returns true if the quantity is equal to zero. +func (q *Quantity) IsZero() bool { + if q.d.Dec != nil { + return q.d.Dec.Sign() == 0 + } + return q.i.value == 0 +} + +// Sign returns 0 if the quantity is zero, -1 if the quantity is less than zero, or 1 if the +// quantity is greater than zero. +func (q *Quantity) Sign() int { + if q.d.Dec != nil { + return q.d.Dec.Sign() + } + return q.i.Sign() +} + +// AsScaled returns the current value, rounded up to the provided scale, and returns +// false if the scale resulted in a loss of precision. +func (q *Quantity) AsScale(scale Scale) (CanonicalValue, bool) { + if q.d.Dec != nil { + return q.d.AsScale(scale) + } + return q.i.AsScale(scale) +} + +// RoundUp updates the quantity to the provided scale, ensuring that the value is at +// least 1. False is returned if the rounding operation resulted in a loss of precision. +// Negative numbers are rounded away from zero (-9 scale 1 rounds to -10). +func (q *Quantity) RoundUp(scale Scale) bool { + if q.d.Dec != nil { + q.s = "" + d, exact := q.d.AsScale(scale) + q.d = d + return exact + } + // avoid clearing the string value if we have already calculated it + if q.i.scale >= scale { + return true + } + q.s = "" + i, exact := q.i.AsScale(scale) + q.i = i + return exact +} + +// Add adds the provide y quantity to the current value. If the current value is zero, +// the format of the quantity will be updated to the format of y. +func (q *Quantity) Add(y Quantity) { + q.s = "" + if q.d.Dec == nil && y.d.Dec == nil { + if q.i.value == 0 { + q.Format = y.Format + } + if q.i.Add(y.i) { + return + } + } else if q.IsZero() { + q.Format = y.Format + } + q.ToDec().d.Dec.Add(q.d.Dec, y.AsDec()) +} + +// Sub subtracts the provided quantity from the current value in place. If the current +// value is zero, the format of the quantity will be updated to the format of y. +func (q *Quantity) Sub(y Quantity) { + q.s = "" + if q.IsZero() { + q.Format = y.Format + } + if q.d.Dec == nil && y.d.Dec == nil && q.i.Sub(y.i) { + return + } + q.ToDec().d.Dec.Sub(q.d.Dec, y.AsDec()) +} + +// Cmp returns 0 if the quantity is equal to y, -1 if the quantity is less than y, or 1 if the +// quantity is greater than y. +func (q *Quantity) Cmp(y Quantity) int { + if q.d.Dec == nil && y.d.Dec == nil { + return q.i.Cmp(y.i) + } + return q.AsDec().Cmp(y.AsDec()) +} + +// CmpInt64 returns 0 if the quantity is equal to y, -1 if the quantity is less than y, or 1 if the +// quantity is greater than y. +func (q *Quantity) CmpInt64(y int64) int { + if q.d.Dec != nil { + return q.d.Dec.Cmp(inf.NewDec(y, inf.Scale(0))) + } + return q.i.Cmp(int64Amount{value: y}) +} + +// Neg sets quantity to be the negative value of itself. +func (q *Quantity) Neg() { + q.s = "" + if q.d.Dec == nil { + q.i.value = -q.i.value + return + } + q.d.Dec.Neg(q.d.Dec) +} + +// int64QuantityExpectedBytes is the expected width in bytes of the canonical string representation +// of most Quantity values. +const int64QuantityExpectedBytes = 18 + +// String formats the Quantity as a string, caching the result if not calculated. +// String is an expensive operation and caching this result significantly reduces the cost of +// normal parse / marshal operations on Quantity. +func (q *Quantity) String() string { + if len(q.s) == 0 { + result := make([]byte, 0, int64QuantityExpectedBytes) + number, suffix := q.CanonicalizeBytes(result) + number = append(number, suffix...) + q.s = string(number) + } + return q.s +} + +// MarshalJSON implements the json.Marshaller interface. +func (q Quantity) MarshalJSON() ([]byte, error) { + if len(q.s) > 0 { + out := make([]byte, len(q.s)+2) + out[0], out[len(out)-1] = '"', '"' + copy(out[1:], q.s) + return out, nil + } + result := make([]byte, int64QuantityExpectedBytes, int64QuantityExpectedBytes) + result[0] = '"' + number, suffix := q.CanonicalizeBytes(result[1:1]) + // if the same slice was returned to us that we passed in, avoid another allocation by copying number into + // the source slice and returning that + if len(number) > 0 && &number[0] == &result[1] && (len(number)+len(suffix)+2) <= int64QuantityExpectedBytes { + number = append(number, suffix...) + number = append(number, '"') + return result[:1+len(number)], nil + } + // if CanonicalizeBytes needed more space than our slice provided, we may need to allocate again so use + // append + result = result[:1] + result = append(result, number...) + result = append(result, suffix...) + result = append(result, '"') + return result, nil +} + +// UnmarshalJSON implements the json.Unmarshaller interface. +// TODO: Remove support for leading/trailing whitespace +func (q *Quantity) UnmarshalJSON(value []byte) error { + l := len(value) + if l == 4 && bytes.Equal(value, []byte("null")) { + q.d.Dec = nil + q.i = int64Amount{} + return nil + } + if l >= 2 && value[0] == '"' && value[l-1] == '"' { + value = value[1 : l-1] + } + + parsed, err := ParseQuantity(strings.TrimSpace(string(value))) + if err != nil { + return err + } + + // This copy is safe because parsed will not be referred to again. + *q = parsed + return nil +} + +// NewQuantity returns a new Quantity representing the given +// value in the given format. +func NewQuantity(value int64, format Format) *Quantity { + return &Quantity{ + i: int64Amount{value: value}, + Format: format, + } +} + +// NewMilliQuantity returns a new Quantity representing the given +// value * 1/1000 in the given format. Note that BinarySI formatting +// will round fractional values, and will be changed to DecimalSI for +// values x where (-1 < x < 1) && (x != 0). +func NewMilliQuantity(value int64, format Format) *Quantity { + return &Quantity{ + i: int64Amount{value: value, scale: -3}, + Format: format, + } +} + +// NewScaledQuantity returns a new Quantity representing the given +// value * 10^scale in DecimalSI format. +func NewScaledQuantity(value int64, scale Scale) *Quantity { + return &Quantity{ + i: int64Amount{value: value, scale: scale}, + Format: DecimalSI, + } +} + +// Value returns the value of q; any fractional part will be lost. +func (q *Quantity) Value() int64 { + return q.ScaledValue(0) +} + +// MilliValue returns the value of ceil(q * 1000); this could overflow an int64; +// if that's a concern, call Value() first to verify the number is small enough. +func (q *Quantity) MilliValue() int64 { + return q.ScaledValue(Milli) +} + +// ScaledValue returns the value of ceil(q * 10^scale); this could overflow an int64. +// To detect overflow, call Value() first and verify the expected magnitude. +func (q *Quantity) ScaledValue(scale Scale) int64 { + if q.d.Dec == nil { + i, _ := q.i.AsScaledInt64(scale) + return i + } + dec := q.d.Dec + return scaledValue(dec.UnscaledBig(), int(dec.Scale()), int(scale.infScale())) +} + +// Set sets q's value to be value. +func (q *Quantity) Set(value int64) { + q.SetScaled(value, 0) +} + +// SetMilli sets q's value to be value * 1/1000. +func (q *Quantity) SetMilli(value int64) { + q.SetScaled(value, Milli) +} + +// SetScaled sets q's value to be value * 10^scale +func (q *Quantity) SetScaled(value int64, scale Scale) { + q.s = "" + q.d.Dec = nil + q.i = int64Amount{value: value, scale: scale} +} + +// Copy is a convenience function that makes a deep copy for you. Non-deep +// copies of quantities share pointers and you will regret that. +func (q *Quantity) Copy() *Quantity { + if q.d.Dec == nil { + return &Quantity{ + s: q.s, + i: q.i, + Format: q.Format, + } + } + tmp := &inf.Dec{} + return &Quantity{ + s: q.s, + d: infDecAmount{tmp.Set(q.d.Dec)}, + Format: q.Format, + } +} diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/quantity_proto.go b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/quantity_proto.go new file mode 100644 index 000000000000..74dfb4e4b7c9 --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/quantity_proto.go @@ -0,0 +1,284 @@ +/* +Copyright 2015 The Kubernetes Authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +*/ + +package resource + +import ( + "fmt" + "io" + + "github.com/gogo/protobuf/proto" +) + +var _ proto.Sizer = &Quantity{} + +func (m *Quantity) Marshal() (data []byte, err error) { + size := m.Size() + data = make([]byte, size) + n, err := m.MarshalTo(data) + if err != nil { + return nil, err + } + return data[:n], nil +} + +// MarshalTo is a customized version of the generated Protobuf unmarshaler for a struct +// with a single string field. +func (m *Quantity) MarshalTo(data []byte) (int, error) { + var i int + _ = i + var l int + _ = l + + data[i] = 0xa + i++ + // BEGIN CUSTOM MARSHAL + out := m.String() + i = encodeVarintGenerated(data, i, uint64(len(out))) + i += copy(data[i:], out) + // END CUSTOM MARSHAL + + return i, nil +} + +func encodeVarintGenerated(data []byte, offset int, v uint64) int { + for v >= 1<<7 { + data[offset] = uint8(v&0x7f | 0x80) + v >>= 7 + offset++ + } + data[offset] = uint8(v) + return offset + 1 +} + +func (m *Quantity) Size() (n int) { + var l int + _ = l + + // BEGIN CUSTOM SIZE + l = len(m.String()) + // END CUSTOM SIZE + + n += 1 + l + sovGenerated(uint64(l)) + return n +} + +func sovGenerated(x uint64) (n int) { + for { + n++ + x >>= 7 + if x == 0 { + break + } + } + return n +} + +// Unmarshal is a customized version of the generated Protobuf unmarshaler for a struct +// with a single string field. +func (m *Quantity) Unmarshal(data []byte) error { + l := len(data) + iNdEx := 0 + for iNdEx < l { + preIndex := iNdEx + var wire uint64 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowGenerated + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := data[iNdEx] + iNdEx++ + wire |= (uint64(b) & 0x7F) << shift + if b < 0x80 { + break + } + } + fieldNum := int32(wire >> 3) + wireType := int(wire & 0x7) + if wireType == 4 { + return fmt.Errorf("proto: Quantity: wiretype end group for non-group") + } + if fieldNum <= 0 { + return fmt.Errorf("proto: Quantity: illegal tag %d (wire type %d)", fieldNum, wire) + } + switch fieldNum { + case 1: + if wireType != 2 { + return fmt.Errorf("proto: wrong wireType = %d for field String_", wireType) + } + var stringLen uint64 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return ErrIntOverflowGenerated + } + if iNdEx >= l { + return io.ErrUnexpectedEOF + } + b := data[iNdEx] + iNdEx++ + stringLen |= (uint64(b) & 0x7F) << shift + if b < 0x80 { + break + } + } + intStringLen := int(stringLen) + if intStringLen < 0 { + return ErrInvalidLengthGenerated + } + postIndex := iNdEx + intStringLen + if postIndex > l { + return io.ErrUnexpectedEOF + } + s := string(data[iNdEx:postIndex]) + + // BEGIN CUSTOM DECODE + p, err := ParseQuantity(s) + if err != nil { + return err + } + *m = p + // END CUSTOM DECODE + + iNdEx = postIndex + default: + iNdEx = preIndex + skippy, err := skipGenerated(data[iNdEx:]) + if err != nil { + return err + } + if skippy < 0 { + return ErrInvalidLengthGenerated + } + if (iNdEx + skippy) > l { + return io.ErrUnexpectedEOF + } + iNdEx += skippy + } + } + + if iNdEx > l { + return io.ErrUnexpectedEOF + } + return nil +} + +func skipGenerated(data []byte) (n int, err error) { + l := len(data) + iNdEx := 0 + for iNdEx < l { + var wire uint64 + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return 0, ErrIntOverflowGenerated + } + if iNdEx >= l { + return 0, io.ErrUnexpectedEOF + } + b := data[iNdEx] + iNdEx++ + wire |= (uint64(b) & 0x7F) << shift + if b < 0x80 { + break + } + } + wireType := int(wire & 0x7) + switch wireType { + case 0: + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return 0, ErrIntOverflowGenerated + } + if iNdEx >= l { + return 0, io.ErrUnexpectedEOF + } + iNdEx++ + if data[iNdEx-1] < 0x80 { + break + } + } + return iNdEx, nil + case 1: + iNdEx += 8 + return iNdEx, nil + case 2: + var length int + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return 0, ErrIntOverflowGenerated + } + if iNdEx >= l { + return 0, io.ErrUnexpectedEOF + } + b := data[iNdEx] + iNdEx++ + length |= (int(b) & 0x7F) << shift + if b < 0x80 { + break + } + } + iNdEx += length + if length < 0 { + return 0, ErrInvalidLengthGenerated + } + return iNdEx, nil + case 3: + for { + var innerWire uint64 + var start int = iNdEx + for shift := uint(0); ; shift += 7 { + if shift >= 64 { + return 0, ErrIntOverflowGenerated + } + if iNdEx >= l { + return 0, io.ErrUnexpectedEOF + } + b := data[iNdEx] + iNdEx++ + innerWire |= (uint64(b) & 0x7F) << shift + if b < 0x80 { + break + } + } + innerWireType := int(innerWire & 0x7) + if innerWireType == 4 { + break + } + next, err := skipGenerated(data[start:]) + if err != nil { + return 0, err + } + iNdEx = start + next + } + return iNdEx, nil + case 4: + return iNdEx, nil + case 5: + iNdEx += 4 + return iNdEx, nil + default: + return 0, fmt.Errorf("proto: illegal wireType %d", wireType) + } + } + panic("unreachable") +} + +var ( + ErrInvalidLengthGenerated = fmt.Errorf("proto: negative length found during unmarshaling") + ErrIntOverflowGenerated = fmt.Errorf("proto: integer overflow") +) diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/scale_int.go b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/scale_int.go new file mode 100644 index 000000000000..55e177b0e9b0 --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/scale_int.go @@ -0,0 +1,95 @@ +/* +Copyright 2015 The Kubernetes Authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +*/ + +package resource + +import ( + "math" + "math/big" + "sync" +) + +var ( + // A sync pool to reduce allocation. + intPool sync.Pool + maxInt64 = big.NewInt(math.MaxInt64) +) + +func init() { + intPool.New = func() interface{} { + return &big.Int{} + } +} + +// scaledValue scales given unscaled value from scale to new Scale and returns +// an int64. It ALWAYS rounds up the result when scale down. The final result might +// overflow. +// +// scale, newScale represents the scale of the unscaled decimal. +// The mathematical value of the decimal is unscaled * 10**(-scale). +func scaledValue(unscaled *big.Int, scale, newScale int) int64 { + dif := scale - newScale + if dif == 0 { + return unscaled.Int64() + } + + // Handle scale up + // This is an easy case, we do not need to care about rounding and overflow. + // If any intermediate operation causes overflow, the result will overflow. + if dif < 0 { + return unscaled.Int64() * int64(math.Pow10(-dif)) + } + + // Handle scale down + // We have to be careful about the intermediate operations. + + // fast path when unscaled < max.Int64 and exp(10,dif) < max.Int64 + const log10MaxInt64 = 19 + if unscaled.Cmp(maxInt64) < 0 && dif < log10MaxInt64 { + divide := int64(math.Pow10(dif)) + result := unscaled.Int64() / divide + mod := unscaled.Int64() % divide + if mod != 0 { + return result + 1 + } + return result + } + + // We should only convert back to int64 when getting the result. + divisor := intPool.Get().(*big.Int) + exp := intPool.Get().(*big.Int) + result := intPool.Get().(*big.Int) + defer func() { + intPool.Put(divisor) + intPool.Put(exp) + intPool.Put(result) + }() + + // divisor = 10^(dif) + // TODO: create loop up table if exp costs too much. + divisor.Exp(bigTen, exp.SetInt64(int64(dif)), nil) + // reuse exp + remainder := exp + + // result = unscaled / divisor + // remainder = unscaled % divisor + result.DivMod(unscaled, divisor, remainder) + if remainder.Sign() != 0 { + return result.Int64() + 1 + } + + return result.Int64() +} diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/suffix.go b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/suffix.go new file mode 100644 index 000000000000..5ed7abe66510 --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/suffix.go @@ -0,0 +1,198 @@ +/* +Copyright 2014 The Kubernetes Authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +*/ + +package resource + +import ( + "strconv" +) + +type suffix string + +// suffixer can interpret and construct suffixes. +type suffixer interface { + interpret(suffix) (base, exponent int32, fmt Format, ok bool) + construct(base, exponent int32, fmt Format) (s suffix, ok bool) + constructBytes(base, exponent int32, fmt Format) (s []byte, ok bool) +} + +// quantitySuffixer handles suffixes for all three formats that quantity +// can handle. +var quantitySuffixer = newSuffixer() + +type bePair struct { + base, exponent int32 +} + +type listSuffixer struct { + suffixToBE map[suffix]bePair + beToSuffix map[bePair]suffix + beToSuffixBytes map[bePair][]byte +} + +func (ls *listSuffixer) addSuffix(s suffix, pair bePair) { + if ls.suffixToBE == nil { + ls.suffixToBE = map[suffix]bePair{} + } + if ls.beToSuffix == nil { + ls.beToSuffix = map[bePair]suffix{} + } + if ls.beToSuffixBytes == nil { + ls.beToSuffixBytes = map[bePair][]byte{} + } + ls.suffixToBE[s] = pair + ls.beToSuffix[pair] = s + ls.beToSuffixBytes[pair] = []byte(s) +} + +func (ls *listSuffixer) lookup(s suffix) (base, exponent int32, ok bool) { + pair, ok := ls.suffixToBE[s] + if !ok { + return 0, 0, false + } + return pair.base, pair.exponent, true +} + +func (ls *listSuffixer) construct(base, exponent int32) (s suffix, ok bool) { + s, ok = ls.beToSuffix[bePair{base, exponent}] + return +} + +func (ls *listSuffixer) constructBytes(base, exponent int32) (s []byte, ok bool) { + s, ok = ls.beToSuffixBytes[bePair{base, exponent}] + return +} + +type suffixHandler struct { + decSuffixes listSuffixer + binSuffixes listSuffixer +} + +type fastLookup struct { + *suffixHandler +} + +func (l fastLookup) interpret(s suffix) (base, exponent int32, format Format, ok bool) { + switch s { + case "": + return 10, 0, DecimalSI, true + case "n": + return 10, -9, DecimalSI, true + case "u": + return 10, -6, DecimalSI, true + case "m": + return 10, -3, DecimalSI, true + case "k": + return 10, 3, DecimalSI, true + case "M": + return 10, 6, DecimalSI, true + case "G": + return 10, 9, DecimalSI, true + } + return l.suffixHandler.interpret(s) +} + +func newSuffixer() suffixer { + sh := &suffixHandler{} + + // IMPORTANT: if you change this section you must change fastLookup + + sh.binSuffixes.addSuffix("Ki", bePair{2, 10}) + sh.binSuffixes.addSuffix("Mi", bePair{2, 20}) + sh.binSuffixes.addSuffix("Gi", bePair{2, 30}) + sh.binSuffixes.addSuffix("Ti", bePair{2, 40}) + sh.binSuffixes.addSuffix("Pi", bePair{2, 50}) + sh.binSuffixes.addSuffix("Ei", bePair{2, 60}) + // Don't emit an error when trying to produce + // a suffix for 2^0. + sh.decSuffixes.addSuffix("", bePair{2, 0}) + + sh.decSuffixes.addSuffix("n", bePair{10, -9}) + sh.decSuffixes.addSuffix("u", bePair{10, -6}) + sh.decSuffixes.addSuffix("m", bePair{10, -3}) + sh.decSuffixes.addSuffix("", bePair{10, 0}) + sh.decSuffixes.addSuffix("k", bePair{10, 3}) + sh.decSuffixes.addSuffix("M", bePair{10, 6}) + sh.decSuffixes.addSuffix("G", bePair{10, 9}) + sh.decSuffixes.addSuffix("T", bePair{10, 12}) + sh.decSuffixes.addSuffix("P", bePair{10, 15}) + sh.decSuffixes.addSuffix("E", bePair{10, 18}) + + return fastLookup{sh} +} + +func (sh *suffixHandler) construct(base, exponent int32, fmt Format) (s suffix, ok bool) { + switch fmt { + case DecimalSI: + return sh.decSuffixes.construct(base, exponent) + case BinarySI: + return sh.binSuffixes.construct(base, exponent) + case DecimalExponent: + if base != 10 { + return "", false + } + if exponent == 0 { + return "", true + } + return suffix("e" + strconv.FormatInt(int64(exponent), 10)), true + } + return "", false +} + +func (sh *suffixHandler) constructBytes(base, exponent int32, format Format) (s []byte, ok bool) { + switch format { + case DecimalSI: + return sh.decSuffixes.constructBytes(base, exponent) + case BinarySI: + return sh.binSuffixes.constructBytes(base, exponent) + case DecimalExponent: + if base != 10 { + return nil, false + } + if exponent == 0 { + return nil, true + } + result := make([]byte, 8, 8) + result[0] = 'e' + number := strconv.AppendInt(result[1:1], int64(exponent), 10) + if &result[1] == &number[0] { + return result[:1+len(number)], true + } + result = append(result[:1], number...) + return result, true + } + return nil, false +} + +func (sh *suffixHandler) interpret(suffix suffix) (base, exponent int32, fmt Format, ok bool) { + // Try lookup tables first + if b, e, ok := sh.decSuffixes.lookup(suffix); ok { + return b, e, DecimalSI, true + } + if b, e, ok := sh.binSuffixes.lookup(suffix); ok { + return b, e, BinarySI, true + } + + if len(suffix) > 1 && (suffix[0] == 'E' || suffix[0] == 'e') { + parsed, err := strconv.ParseInt(string(suffix[1:]), 10, 64) + if err != nil { + return 0, 0, DecimalExponent, false + } + return 10, int32(parsed), DecimalExponent, true + } + + return 0, 0, DecimalExponent, false +} diff --git a/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/zz_generated.deepcopy.go b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/zz_generated.deepcopy.go new file mode 100644 index 000000000000..ab47407900cf --- /dev/null +++ b/metricbeat/vendor/github.com/kubernetes/apimachinery/pkg/api/resource/zz_generated.deepcopy.go @@ -0,0 +1,27 @@ +// +build !ignore_autogenerated + +/* +Copyright The Kubernetes Authors. + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. +*/ + +// Code generated by deepcopy-gen. DO NOT EDIT. + +package resource + +// DeepCopyInto is an autogenerated deepcopy function, copying the receiver, writing into out. in must be non-nil. +func (in *Quantity) DeepCopyInto(out *Quantity) { + *out = in.DeepCopy() + return +} diff --git a/metricbeat/vendor/gopkg.in/inf.v0/LICENSE b/metricbeat/vendor/gopkg.in/inf.v0/LICENSE new file mode 100644 index 000000000000..87a5cede3392 --- /dev/null +++ b/metricbeat/vendor/gopkg.in/inf.v0/LICENSE @@ -0,0 +1,28 @@ +Copyright (c) 2012 Péter Surányi. Portions Copyright (c) 2009 The Go +Authors. All rights reserved. + +Redistribution and use in source and binary forms, with or without +modification, are permitted provided that the following conditions are +met: + + * Redistributions of source code must retain the above copyright +notice, this list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above +copyright notice, this list of conditions and the following disclaimer +in the documentation and/or other materials provided with the +distribution. + * Neither the name of Google Inc. nor the names of its +contributors may be used to endorse or promote products derived from +this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS +"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT +LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR +A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT +OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, +SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT +LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE +OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/metricbeat/vendor/gopkg.in/inf.v0/dec.go b/metricbeat/vendor/gopkg.in/inf.v0/dec.go new file mode 100644 index 000000000000..26548b63cef4 --- /dev/null +++ b/metricbeat/vendor/gopkg.in/inf.v0/dec.go @@ -0,0 +1,615 @@ +// Package inf (type inf.Dec) implements "infinite-precision" decimal +// arithmetic. +// "Infinite precision" describes two characteristics: practically unlimited +// precision for decimal number representation and no support for calculating +// with any specific fixed precision. +// (Although there is no practical limit on precision, inf.Dec can only +// represent finite decimals.) +// +// This package is currently in experimental stage and the API may change. +// +// This package does NOT support: +// - rounding to specific precisions (as opposed to specific decimal positions) +// - the notion of context (each rounding must be explicit) +// - NaN and Inf values, and distinguishing between positive and negative zero +// - conversions to and from float32/64 types +// +// Features considered for possible addition: +// + formatting options +// + Exp method +// + combined operations such as AddRound/MulAdd etc +// + exchanging data in decimal32/64/128 formats +// +package inf // import "gopkg.in/inf.v0" + +// TODO: +// - avoid excessive deep copying (quo and rounders) + +import ( + "fmt" + "io" + "math/big" + "strings" +) + +// A Dec represents a signed arbitrary-precision decimal. +// It is a combination of a sign, an arbitrary-precision integer coefficient +// value, and a signed fixed-precision exponent value. +// The sign and the coefficient value are handled together as a signed value +// and referred to as the unscaled value. +// (Positive and negative zero values are not distinguished.) +// Since the exponent is most commonly non-positive, it is handled in negated +// form and referred to as scale. +// +// The mathematical value of a Dec equals: +// +// unscaled * 10**(-scale) +// +// Note that different Dec representations may have equal mathematical values. +// +// unscaled scale String() +// ------------------------- +// 0 0 "0" +// 0 2 "0.00" +// 0 -2 "0" +// 1 0 "1" +// 100 2 "1.00" +// 10 0 "10" +// 1 -1 "10" +// +// The zero value for a Dec represents the value 0 with scale 0. +// +// Operations are typically performed through the *Dec type. +// The semantics of the assignment operation "=" for "bare" Dec values is +// undefined and should not be relied on. +// +// Methods are typically of the form: +// +// func (z *Dec) Op(x, y *Dec) *Dec +// +// and implement operations z = x Op y with the result as receiver; if it +// is one of the operands it may be overwritten (and its memory reused). +// To enable chaining of operations, the result is also returned. Methods +// returning a result other than *Dec take one of the operands as the receiver. +// +// A "bare" Quo method (quotient / division operation) is not provided, as the +// result is not always a finite decimal and thus in general cannot be +// represented as a Dec. +// Instead, in the common case when rounding is (potentially) necessary, +// QuoRound should be used with a Scale and a Rounder. +// QuoExact or QuoRound with RoundExact can be used in the special cases when it +// is known that the result is always a finite decimal. +// +type Dec struct { + unscaled big.Int + scale Scale +} + +// Scale represents the type used for the scale of a Dec. +type Scale int32 + +const scaleSize = 4 // bytes in a Scale value + +// Scaler represents a method for obtaining the scale to use for the result of +// an operation on x and y. +type scaler interface { + Scale(x *Dec, y *Dec) Scale +} + +var bigInt = [...]*big.Int{ + big.NewInt(0), big.NewInt(1), big.NewInt(2), big.NewInt(3), big.NewInt(4), + big.NewInt(5), big.NewInt(6), big.NewInt(7), big.NewInt(8), big.NewInt(9), + big.NewInt(10), +} + +var exp10cache [64]big.Int = func() [64]big.Int { + e10, e10i := [64]big.Int{}, bigInt[1] + for i := range e10 { + e10[i].Set(e10i) + e10i = new(big.Int).Mul(e10i, bigInt[10]) + } + return e10 +}() + +// NewDec allocates and returns a new Dec set to the given int64 unscaled value +// and scale. +func NewDec(unscaled int64, scale Scale) *Dec { + return new(Dec).SetUnscaled(unscaled).SetScale(scale) +} + +// NewDecBig allocates and returns a new Dec set to the given *big.Int unscaled +// value and scale. +func NewDecBig(unscaled *big.Int, scale Scale) *Dec { + return new(Dec).SetUnscaledBig(unscaled).SetScale(scale) +} + +// Scale returns the scale of x. +func (x *Dec) Scale() Scale { + return x.scale +} + +// Unscaled returns the unscaled value of x for u and true for ok when the +// unscaled value can be represented as int64; otherwise it returns an undefined +// int64 value for u and false for ok. Use x.UnscaledBig().Int64() to avoid +// checking the validity of the value when the check is known to be redundant. +func (x *Dec) Unscaled() (u int64, ok bool) { + u = x.unscaled.Int64() + var i big.Int + ok = i.SetInt64(u).Cmp(&x.unscaled) == 0 + return +} + +// UnscaledBig returns the unscaled value of x as *big.Int. +func (x *Dec) UnscaledBig() *big.Int { + return &x.unscaled +} + +// SetScale sets the scale of z, with the unscaled value unchanged, and returns +// z. +// The mathematical value of the Dec changes as if it was multiplied by +// 10**(oldscale-scale). +func (z *Dec) SetScale(scale Scale) *Dec { + z.scale = scale + return z +} + +// SetUnscaled sets the unscaled value of z, with the scale unchanged, and +// returns z. +func (z *Dec) SetUnscaled(unscaled int64) *Dec { + z.unscaled.SetInt64(unscaled) + return z +} + +// SetUnscaledBig sets the unscaled value of z, with the scale unchanged, and +// returns z. +func (z *Dec) SetUnscaledBig(unscaled *big.Int) *Dec { + z.unscaled.Set(unscaled) + return z +} + +// Set sets z to the value of x and returns z. +// It does nothing if z == x. +func (z *Dec) Set(x *Dec) *Dec { + if z != x { + z.SetUnscaledBig(x.UnscaledBig()) + z.SetScale(x.Scale()) + } + return z +} + +// Sign returns: +// +// -1 if x < 0 +// 0 if x == 0 +// +1 if x > 0 +// +func (x *Dec) Sign() int { + return x.UnscaledBig().Sign() +} + +// Neg sets z to -x and returns z. +func (z *Dec) Neg(x *Dec) *Dec { + z.SetScale(x.Scale()) + z.UnscaledBig().Neg(x.UnscaledBig()) + return z +} + +// Cmp compares x and y and returns: +// +// -1 if x < y +// 0 if x == y +// +1 if x > y +// +func (x *Dec) Cmp(y *Dec) int { + xx, yy := upscale(x, y) + return xx.UnscaledBig().Cmp(yy.UnscaledBig()) +} + +// Abs sets z to |x| (the absolute value of x) and returns z. +func (z *Dec) Abs(x *Dec) *Dec { + z.SetScale(x.Scale()) + z.UnscaledBig().Abs(x.UnscaledBig()) + return z +} + +// Add sets z to the sum x+y and returns z. +// The scale of z is the greater of the scales of x and y. +func (z *Dec) Add(x, y *Dec) *Dec { + xx, yy := upscale(x, y) + z.SetScale(xx.Scale()) + z.UnscaledBig().Add(xx.UnscaledBig(), yy.UnscaledBig()) + return z +} + +// Sub sets z to the difference x-y and returns z. +// The scale of z is the greater of the scales of x and y. +func (z *Dec) Sub(x, y *Dec) *Dec { + xx, yy := upscale(x, y) + z.SetScale(xx.Scale()) + z.UnscaledBig().Sub(xx.UnscaledBig(), yy.UnscaledBig()) + return z +} + +// Mul sets z to the product x*y and returns z. +// The scale of z is the sum of the scales of x and y. +func (z *Dec) Mul(x, y *Dec) *Dec { + z.SetScale(x.Scale() + y.Scale()) + z.UnscaledBig().Mul(x.UnscaledBig(), y.UnscaledBig()) + return z +} + +// Round sets z to the value of x rounded to Scale s using Rounder r, and +// returns z. +func (z *Dec) Round(x *Dec, s Scale, r Rounder) *Dec { + return z.QuoRound(x, NewDec(1, 0), s, r) +} + +// QuoRound sets z to the quotient x/y, rounded using the given Rounder to the +// specified scale. +// +// If the rounder is RoundExact but the result can not be expressed exactly at +// the specified scale, QuoRound returns nil, and the value of z is undefined. +// +// There is no corresponding Div method; the equivalent can be achieved through +// the choice of Rounder used. +// +func (z *Dec) QuoRound(x, y *Dec, s Scale, r Rounder) *Dec { + return z.quo(x, y, sclr{s}, r) +} + +func (z *Dec) quo(x, y *Dec, s scaler, r Rounder) *Dec { + scl := s.Scale(x, y) + var zzz *Dec + if r.UseRemainder() { + zz, rA, rB := new(Dec).quoRem(x, y, scl, true, new(big.Int), new(big.Int)) + zzz = r.Round(new(Dec), zz, rA, rB) + } else { + zz, _, _ := new(Dec).quoRem(x, y, scl, false, nil, nil) + zzz = r.Round(new(Dec), zz, nil, nil) + } + if zzz == nil { + return nil + } + return z.Set(zzz) +} + +// QuoExact sets z to the quotient x/y and returns z when x/y is a finite +// decimal. Otherwise it returns nil and the value of z is undefined. +// +// The scale of a non-nil result is "x.Scale() - y.Scale()" or greater; it is +// calculated so that the remainder will be zero whenever x/y is a finite +// decimal. +func (z *Dec) QuoExact(x, y *Dec) *Dec { + return z.quo(x, y, scaleQuoExact{}, RoundExact) +} + +// quoRem sets z to the quotient x/y with the scale s, and if useRem is true, +// it sets remNum and remDen to the numerator and denominator of the remainder. +// It returns z, remNum and remDen. +// +// The remainder is normalized to the range -1 < r < 1 to simplify rounding; +// that is, the results satisfy the following equation: +// +// x / y = z + (remNum/remDen) * 10**(-z.Scale()) +// +// See Rounder for more details about rounding. +// +func (z *Dec) quoRem(x, y *Dec, s Scale, useRem bool, + remNum, remDen *big.Int) (*Dec, *big.Int, *big.Int) { + // difference (required adjustment) compared to "canonical" result scale + shift := s - (x.Scale() - y.Scale()) + // pointers to adjusted unscaled dividend and divisor + var ix, iy *big.Int + switch { + case shift > 0: + // increased scale: decimal-shift dividend left + ix = new(big.Int).Mul(x.UnscaledBig(), exp10(shift)) + iy = y.UnscaledBig() + case shift < 0: + // decreased scale: decimal-shift divisor left + ix = x.UnscaledBig() + iy = new(big.Int).Mul(y.UnscaledBig(), exp10(-shift)) + default: + ix = x.UnscaledBig() + iy = y.UnscaledBig() + } + // save a copy of iy in case it to be overwritten with the result + iy2 := iy + if iy == z.UnscaledBig() { + iy2 = new(big.Int).Set(iy) + } + // set scale + z.SetScale(s) + // set unscaled + if useRem { + // Int division + _, intr := z.UnscaledBig().QuoRem(ix, iy, new(big.Int)) + // set remainder + remNum.Set(intr) + remDen.Set(iy2) + } else { + z.UnscaledBig().Quo(ix, iy) + } + return z, remNum, remDen +} + +type sclr struct{ s Scale } + +func (s sclr) Scale(x, y *Dec) Scale { + return s.s +} + +type scaleQuoExact struct{} + +func (sqe scaleQuoExact) Scale(x, y *Dec) Scale { + rem := new(big.Rat).SetFrac(x.UnscaledBig(), y.UnscaledBig()) + f2, f5 := factor2(rem.Denom()), factor(rem.Denom(), bigInt[5]) + var f10 Scale + if f2 > f5 { + f10 = Scale(f2) + } else { + f10 = Scale(f5) + } + return x.Scale() - y.Scale() + f10 +} + +func factor(n *big.Int, p *big.Int) int { + // could be improved for large factors + d, f := n, 0 + for { + dd, dm := new(big.Int).DivMod(d, p, new(big.Int)) + if dm.Sign() == 0 { + f++ + d = dd + } else { + break + } + } + return f +} + +func factor2(n *big.Int) int { + // could be improved for large factors + f := 0 + for ; n.Bit(f) == 0; f++ { + } + return f +} + +func upscale(a, b *Dec) (*Dec, *Dec) { + if a.Scale() == b.Scale() { + return a, b + } + if a.Scale() > b.Scale() { + bb := b.rescale(a.Scale()) + return a, bb + } + aa := a.rescale(b.Scale()) + return aa, b +} + +func exp10(x Scale) *big.Int { + if int(x) < len(exp10cache) { + return &exp10cache[int(x)] + } + return new(big.Int).Exp(bigInt[10], big.NewInt(int64(x)), nil) +} + +func (x *Dec) rescale(newScale Scale) *Dec { + shift := newScale - x.Scale() + switch { + case shift < 0: + e := exp10(-shift) + return NewDecBig(new(big.Int).Quo(x.UnscaledBig(), e), newScale) + case shift > 0: + e := exp10(shift) + return NewDecBig(new(big.Int).Mul(x.UnscaledBig(), e), newScale) + } + return x +} + +var zeros = []byte("00000000000000000000000000000000" + + "00000000000000000000000000000000") +var lzeros = Scale(len(zeros)) + +func appendZeros(s []byte, n Scale) []byte { + for i := Scale(0); i < n; i += lzeros { + if n > i+lzeros { + s = append(s, zeros...) + } else { + s = append(s, zeros[0:n-i]...) + } + } + return s +} + +func (x *Dec) String() string { + if x == nil { + return "" + } + scale := x.Scale() + s := []byte(x.UnscaledBig().String()) + if scale <= 0 { + if scale != 0 && x.unscaled.Sign() != 0 { + s = appendZeros(s, -scale) + } + return string(s) + } + negbit := Scale(-((x.Sign() - 1) / 2)) + // scale > 0 + lens := Scale(len(s)) + if lens-negbit <= scale { + ss := make([]byte, 0, scale+2) + if negbit == 1 { + ss = append(ss, '-') + } + ss = append(ss, '0', '.') + ss = appendZeros(ss, scale-lens+negbit) + ss = append(ss, s[negbit:]...) + return string(ss) + } + // lens > scale + ss := make([]byte, 0, lens+1) + ss = append(ss, s[:lens-scale]...) + ss = append(ss, '.') + ss = append(ss, s[lens-scale:]...) + return string(ss) +} + +// Format is a support routine for fmt.Formatter. It accepts the decimal +// formats 'd' and 'f', and handles both equivalently. +// Width, precision, flags and bases 2, 8, 16 are not supported. +func (x *Dec) Format(s fmt.State, ch rune) { + if ch != 'd' && ch != 'f' && ch != 'v' && ch != 's' { + fmt.Fprintf(s, "%%!%c(dec.Dec=%s)", ch, x.String()) + return + } + fmt.Fprintf(s, x.String()) +} + +func (z *Dec) scan(r io.RuneScanner) (*Dec, error) { + unscaled := make([]byte, 0, 256) // collects chars of unscaled as bytes + dp, dg := -1, -1 // indexes of decimal point, first digit +loop: + for { + ch, _, err := r.ReadRune() + if err == io.EOF { + break loop + } + if err != nil { + return nil, err + } + switch { + case ch == '+' || ch == '-': + if len(unscaled) > 0 || dp >= 0 { // must be first character + r.UnreadRune() + break loop + } + case ch == '.': + if dp >= 0 { + r.UnreadRune() + break loop + } + dp = len(unscaled) + continue // don't add to unscaled + case ch >= '0' && ch <= '9': + if dg == -1 { + dg = len(unscaled) + } + default: + r.UnreadRune() + break loop + } + unscaled = append(unscaled, byte(ch)) + } + if dg == -1 { + return nil, fmt.Errorf("no digits read") + } + if dp >= 0 { + z.SetScale(Scale(len(unscaled) - dp)) + } else { + z.SetScale(0) + } + _, ok := z.UnscaledBig().SetString(string(unscaled), 10) + if !ok { + return nil, fmt.Errorf("invalid decimal: %s", string(unscaled)) + } + return z, nil +} + +// SetString sets z to the value of s, interpreted as a decimal (base 10), +// and returns z and a boolean indicating success. The scale of z is the +// number of digits after the decimal point (including any trailing 0s), +// or 0 if there is no decimal point. If SetString fails, the value of z +// is undefined but the returned value is nil. +func (z *Dec) SetString(s string) (*Dec, bool) { + r := strings.NewReader(s) + _, err := z.scan(r) + if err != nil { + return nil, false + } + _, _, err = r.ReadRune() + if err != io.EOF { + return nil, false + } + // err == io.EOF => scan consumed all of s + return z, true +} + +// Scan is a support routine for fmt.Scanner; it sets z to the value of +// the scanned number. It accepts the decimal formats 'd' and 'f', and +// handles both equivalently. Bases 2, 8, 16 are not supported. +// The scale of z is the number of digits after the decimal point +// (including any trailing 0s), or 0 if there is no decimal point. +func (z *Dec) Scan(s fmt.ScanState, ch rune) error { + if ch != 'd' && ch != 'f' && ch != 's' && ch != 'v' { + return fmt.Errorf("Dec.Scan: invalid verb '%c'", ch) + } + s.SkipSpace() + _, err := z.scan(s) + return err +} + +// Gob encoding version +const decGobVersion byte = 1 + +func scaleBytes(s Scale) []byte { + buf := make([]byte, scaleSize) + i := scaleSize + for j := 0; j < scaleSize; j++ { + i-- + buf[i] = byte(s) + s >>= 8 + } + return buf +} + +func scale(b []byte) (s Scale) { + for j := 0; j < scaleSize; j++ { + s <<= 8 + s |= Scale(b[j]) + } + return +} + +// GobEncode implements the gob.GobEncoder interface. +func (x *Dec) GobEncode() ([]byte, error) { + buf, err := x.UnscaledBig().GobEncode() + if err != nil { + return nil, err + } + buf = append(append(buf, scaleBytes(x.Scale())...), decGobVersion) + return buf, nil +} + +// GobDecode implements the gob.GobDecoder interface. +func (z *Dec) GobDecode(buf []byte) error { + if len(buf) == 0 { + return fmt.Errorf("Dec.GobDecode: no data") + } + b := buf[len(buf)-1] + if b != decGobVersion { + return fmt.Errorf("Dec.GobDecode: encoding version %d not supported", b) + } + l := len(buf) - scaleSize - 1 + err := z.UnscaledBig().GobDecode(buf[:l]) + if err != nil { + return err + } + z.SetScale(scale(buf[l : l+scaleSize])) + return nil +} + +// MarshalText implements the encoding.TextMarshaler interface. +func (x *Dec) MarshalText() ([]byte, error) { + return []byte(x.String()), nil +} + +// UnmarshalText implements the encoding.TextUnmarshaler interface. +func (z *Dec) UnmarshalText(data []byte) error { + _, ok := z.SetString(string(data)) + if !ok { + return fmt.Errorf("invalid inf.Dec") + } + return nil +} diff --git a/metricbeat/vendor/gopkg.in/inf.v0/rounder.go b/metricbeat/vendor/gopkg.in/inf.v0/rounder.go new file mode 100644 index 000000000000..3a97ef529b97 --- /dev/null +++ b/metricbeat/vendor/gopkg.in/inf.v0/rounder.go @@ -0,0 +1,145 @@ +package inf + +import ( + "math/big" +) + +// Rounder represents a method for rounding the (possibly infinite decimal) +// result of a division to a finite Dec. It is used by Dec.Round() and +// Dec.Quo(). +// +// See the Example for results of using each Rounder with some sample values. +// +type Rounder rounder + +// See http://speleotrove.com/decimal/damodel.html#refround for more detailed +// definitions of these rounding modes. +var ( + RoundDown Rounder // towards 0 + RoundUp Rounder // away from 0 + RoundFloor Rounder // towards -infinity + RoundCeil Rounder // towards +infinity + RoundHalfDown Rounder // to nearest; towards 0 if same distance + RoundHalfUp Rounder // to nearest; away from 0 if same distance + RoundHalfEven Rounder // to nearest; even last digit if same distance +) + +// RoundExact is to be used in the case when rounding is not necessary. +// When used with Quo or Round, it returns the result verbatim when it can be +// expressed exactly with the given precision, and it returns nil otherwise. +// QuoExact is a shorthand for using Quo with RoundExact. +var RoundExact Rounder + +type rounder interface { + + // When UseRemainder() returns true, the Round() method is passed the + // remainder of the division, expressed as the numerator and denominator of + // a rational. + UseRemainder() bool + + // Round sets the rounded value of a quotient to z, and returns z. + // quo is rounded down (truncated towards zero) to the scale obtained from + // the Scaler in Quo(). + // + // When the remainder is not used, remNum and remDen are nil. + // When used, the remainder is normalized between -1 and 1; that is: + // + // -|remDen| < remNum < |remDen| + // + // remDen has the same sign as y, and remNum is zero or has the same sign + // as x. + Round(z, quo *Dec, remNum, remDen *big.Int) *Dec +} + +type rndr struct { + useRem bool + round func(z, quo *Dec, remNum, remDen *big.Int) *Dec +} + +func (r rndr) UseRemainder() bool { + return r.useRem +} + +func (r rndr) Round(z, quo *Dec, remNum, remDen *big.Int) *Dec { + return r.round(z, quo, remNum, remDen) +} + +var intSign = []*big.Int{big.NewInt(-1), big.NewInt(0), big.NewInt(1)} + +func roundHalf(f func(c int, odd uint) (roundUp bool)) func(z, q *Dec, rA, rB *big.Int) *Dec { + return func(z, q *Dec, rA, rB *big.Int) *Dec { + z.Set(q) + brA, brB := rA.BitLen(), rB.BitLen() + if brA < brB-1 { + // brA < brB-1 => |rA| < |rB/2| + return z + } + roundUp := false + srA, srB := rA.Sign(), rB.Sign() + s := srA * srB + if brA == brB-1 { + rA2 := new(big.Int).Lsh(rA, 1) + if s < 0 { + rA2.Neg(rA2) + } + roundUp = f(rA2.Cmp(rB)*srB, z.UnscaledBig().Bit(0)) + } else { + // brA > brB-1 => |rA| > |rB/2| + roundUp = true + } + if roundUp { + z.UnscaledBig().Add(z.UnscaledBig(), intSign[s+1]) + } + return z + } +} + +func init() { + RoundExact = rndr{true, + func(z, q *Dec, rA, rB *big.Int) *Dec { + if rA.Sign() != 0 { + return nil + } + return z.Set(q) + }} + RoundDown = rndr{false, + func(z, q *Dec, rA, rB *big.Int) *Dec { + return z.Set(q) + }} + RoundUp = rndr{true, + func(z, q *Dec, rA, rB *big.Int) *Dec { + z.Set(q) + if rA.Sign() != 0 { + z.UnscaledBig().Add(z.UnscaledBig(), intSign[rA.Sign()*rB.Sign()+1]) + } + return z + }} + RoundFloor = rndr{true, + func(z, q *Dec, rA, rB *big.Int) *Dec { + z.Set(q) + if rA.Sign()*rB.Sign() < 0 { + z.UnscaledBig().Add(z.UnscaledBig(), intSign[0]) + } + return z + }} + RoundCeil = rndr{true, + func(z, q *Dec, rA, rB *big.Int) *Dec { + z.Set(q) + if rA.Sign()*rB.Sign() > 0 { + z.UnscaledBig().Add(z.UnscaledBig(), intSign[2]) + } + return z + }} + RoundHalfDown = rndr{true, roundHalf( + func(c int, odd uint) bool { + return c > 0 + })} + RoundHalfUp = rndr{true, roundHalf( + func(c int, odd uint) bool { + return c >= 0 + })} + RoundHalfEven = rndr{true, roundHalf( + func(c int, odd uint) bool { + return c > 0 || c == 0 && odd == 1 + })} +} diff --git a/metricbeat/vendor/vendor.json b/metricbeat/vendor/vendor.json index a71efb7805ea..a6365e72c522 100644 --- a/metricbeat/vendor/vendor.json +++ b/metricbeat/vendor/vendor.json @@ -2,12 +2,31 @@ "comment": "", "ignore": "test github.com/elastic/beats", "package": [ + { + "checksumSHA1": "GYschMPw/Zi5C4QnGKRfgljnx/c=", + "path": "github.com/gogo/protobuf/proto", + "revision": "636bf0302bc95575d69441b25a2603156ffdddf1", + "revisionTime": "2018-07-17T14:19:46Z" + }, { "checksumSHA1": "WX1+2gktHcBmE9MGwFSGs7oqexU=", "path": "github.com/golang/protobuf/proto", "revision": "bbd03ef6da3a115852eaf24c8a1c46aeb39aa175", "revisionTime": "2018-02-02T18:43:18Z" }, + { + "checksumSHA1": "A5jBCqiiWtbrWkLM33q+GK75LjQ=", + "path": "github.com/kubernetes/apimachinery/pkg/api/resource", + "revision": "103fd098999dc9c0c88536f5c9ad2e5da39373ae", + "revisionTime": "2018-06-21T03:03:51Z", + "version": "kubernetes-1.11.1", + "versionExact": "kubernetes-1.11.1" + }, + { + "path": "github.com/kubernetes/apimachinery/pkg/api/resource/", + "revision": "kubernetes-1.11.1", + "version": "kubernetes-1.11.1" + }, { "checksumSHA1": "bKMZjd2wPw13VwoE7mBeSv5djFA=", "path": "github.com/matttproud/golang_protobuf_extensions/pbutil", @@ -37,6 +56,12 @@ "path": "github.com/prometheus/common/model", "revision": "89604d197083d4781071d3c65855d24ecfb0a563", "revisionTime": "2018-01-10T21:49:58Z" + }, + { + "checksumSHA1": "COfXAfInbcFT/YRsvLUQnNKHzF0=", + "path": "gopkg.in/inf.v0", + "revision": "d2d2541c53f18d2a059457998ce2876cc8e67cbf", + "revisionTime": "2018-03-26T17:23:32Z" } ], "rootPath": "github.com/elastic/beats/metricbeat" From 5d32a72fad5ffaa074e932f37cc3c9887eb379b7 Mon Sep 17 00:00:00 2001 From: Nicolas Ruflin Date: Mon, 23 Jul 2018 23:20:24 +0200 Subject: [PATCH 27/34] Fix misspell in Beats repo (#7679) Running `make misspell`. --- filebeat/registrar/registrar.go | 2 +- filebeat/scripts/generator/fields/main.go | 4 ++-- metricbeat/docs/fields.asciidoc | 2 +- metricbeat/module/kibana/fields.go | 2 +- metricbeat/module/kibana/stats/_meta/fields.yml | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/filebeat/registrar/registrar.go b/filebeat/registrar/registrar.go index 5a2a6d0c1353..54b06a7cf1bc 100644 --- a/filebeat/registrar/registrar.go +++ b/filebeat/registrar/registrar.go @@ -155,7 +155,7 @@ func readStatesFrom(in io.Reader) ([]file.State, error) { return states, nil } -// fixStates cleans up the regsitry states when updating from an older version +// fixStates cleans up the registry states when updating from an older version // of filebeat potentially writing invalid entries. func fixStates(states []file.State) []file.State { if len(states) == 0 { diff --git a/filebeat/scripts/generator/fields/main.go b/filebeat/scripts/generator/fields/main.go index 385677163e59..be289426937b 100644 --- a/filebeat/scripts/generator/fields/main.go +++ b/filebeat/scripts/generator/fields/main.go @@ -121,8 +121,8 @@ func newField(pattern string) field { } // isValidFormat checks if the input can be split correctly -// 1. if lenght is 2, the format is {type}:{field.elements} -// 2. if the lenght is 3, the format is {type}:{field.elements}:{hint} +// 1. if length is 2, the format is {type}:{field.elements} +// 2. if the length is 3, the format is {type}:{field.elements}:{hint} func isValidFormat(ee []string) bool { return len(ee) == 2 || len(ee) == 3 } diff --git a/metricbeat/docs/fields.asciidoc b/metricbeat/docs/fields.asciidoc index 650e2073ad64..324d08b99dbd 100644 --- a/metricbeat/docs/fields.asciidoc +++ b/metricbeat/docs/fields.asciidoc @@ -6766,7 +6766,7 @@ Kibana instance's health status -- type: long -Number of client connections made to the server. Note that browsers can send multiple simultaneous connections to request mulitple server assets at once, and they can re-use established connections. +Number of client connections made to the server. Note that browsers can send multiple simultaneous connections to request multiple server assets at once, and they can re-use established connections. -- diff --git a/metricbeat/module/kibana/fields.go b/metricbeat/module/kibana/fields.go index 68bf480e11b0..aaa6179dd70f 100644 --- a/metricbeat/module/kibana/fields.go +++ b/metricbeat/module/kibana/fields.go @@ -31,5 +31,5 @@ func init() { // Asset returns asset data func Asset() string { - return "eJzEmM9u4zYQxu9+ikEue9noAXwoULQFWhQJim2DHorCGIljiw1FqpyRY/fpC1KSI8tUrOzKiA5BItnf9+Nw/oi5h2c6ruFZ52hxBSBaDK3h7td4424FoIgLr2vRzq7huxUAQPsQKqcaQysALp2XTeHsVu/WsEXD4a4nQ8i0hpwkSDOJaLvjNfx1x2zu/l4BbDUZxeuoeg8WKxqwhEuONa1h511Td3cSPOc6Qy0WFD7dTclNSrZXt9SoA2gV+Mbei64IKhKvC84GHx+vuL/GdEPCptHq7EEP+UzHF+fHz95AHeBqy4K2IHh6+uXHpG34mbQVOsi3eV5I957aKjost9ZHrAjctvP/xKCtkLdoEkY9QulYssm1LxLyYDEZAvFouQ7Vgkp5Yl6cg8nvyX/iE0fM2mCZBNqTZ+3s4hgp3VNRWqy5dOM0a01z5wzhGOiK6Z8lSUkepKQeIG+0UaAZ8OTX3ksjCUqz/Gb0SRG2g9BImTLqGQpni8Z7srGVWiqCeJrJOLt7Z7E0VU4+lEthNFmBgQVUqAjExfC1+ZPBoxMCKVEg9+6FyTMUaIHJKqgaI7o2BKzDr2jJNXymKA48/dsQS/iwlvjhqAzITKGXCjhb0OeYnlLSMcp7um+YgFgwN5pLUkPZLBm32rtiqpLGnX5GpH5r5fr+PnqeauWvKLQPu2ecqzeKDB6zavz9HowLNKQ2W+NwXAdXCQF+Cj4QfCD6gLZQaWM0U+GsGpv2eBVVzh+zknAck7fiNYOnj1lQngjcVOgGvdEJmiw/Cl1+943Ej9LOVyhrmPry1QUA/BHc2wWgMa5AIRXSuMuuEOG0+mmQM6kPo/85cAcCyI/zkVn/RxujKy0fBv6AhwycUcA1FhSJzuP/6BRl/3C/qM8zNqIO72ep0ruynBm4T1E7tNFBkCcrryfqWuFSHQrgS9dbC9dYeVeneoVSmrvWeotAvc6bbvHcDpMX8jSwpvFcHbWDG5C1hW4v+CZ2jmtnmTZh25favy+dKATR9w2aVzLc726T4t/vyeOOTkuPlFcGzGDE4OE2WA940FVTzcSafK979wHw96jQbcc3nvVue/AI6uk3pNueMYN62rc7BGRtsd3qjNHVchqhTYDMhaQ2Jgt/Lr8FnXo0m9iCdJF/dQt5aOUu0xJmtI5ZBw1YoGZ/aF0GhtNv83A5L6eR0q+ps5j60Rn2SrOM/oPTX1MhhNkDFK7FbyYvJEbWcH6+HVGYMVBvSXoG938AAAD//7lENR0=" + return "eJzEmM1u4zYQx+9+ikEue9noAXQoULQFWhQJim2DHorCGIljiw1FqpyRY/fpC+rDkWUqVnYlRIcgkez//8fhfIi5h2c6pfCsM7S4ARAthlK4+7W5cbcBUMS515VoZ1P4bgMA0D6E0qna0AaAC+dlmzu70/sUdmg43PVkCJlSyEiCNJOItntO4a87ZnP39wZgp8koThvVe7BY0oAlXHKqKIW9d3XV3YnwXOoMtVhQ+Hw3Jjcp2V7dUhsdQKvA1/ZedElQknidczL4+HjF/TWmGxLWtVYXD3rIZzq9OD9+9gbqAFdbFrQ5wdPTLz9GbcPPqK3QUb7N80q699RW0XG5tT5iSeB2nf8nBm2FvEUTMeoRCseSTK59kZAHi8kQiEfLVagWVMoT8+IcTP5A/hOfOZqsDZZRoAN51s4ujhHTPRelxYoLN06z1jRzzhCOgW6Y/lmQFORBCuoBslobBZoBz37tvTiSoNTLb0afFGE7CI0UMaOeIXc2r70n27RSS3kQjzMZZ/fvLJa6zMiHcsmNJiswsIASFYG4Jnxt/iTw6IRAChTIvHth8gw5WmCyCsraiK4MAevwK1pyNV8oigNP/9bEMvhwowzITKGXCjib0+cmPaWgUyPv6b5mAmLBzGguSA1lk2jcKu/yqUoad/oZkfqtlev7++h5rJW/otAh7J5xrtoqMnhKyvH3ezDO0ZDa7ozDcR3cJAT4KfhA8IHGB7SFUhujmXJn1di0xyupdP6UFITjmLwVrxk8fcyC8kTgpkI36I1O0CTZSej6u28kfiPtfImSwtSXby4A4I/g3i4AjXE5CqmQxl12hQjH1c+DnEl9GP3PgTsQQHaaj8z6P9oaXWr5MPAHPCbgjAKuMKeG6DL+j05R8g/3i/o8YyOq8H4WK70by5mB+9RohzY6CPJk5fVEXStcqkMBfOl6a+5qK+/qVK9QSnPXWtcI1Ou86RbP7TB5IU8DaxrP1VE7WIGsLXR7xTexc1w5y7QN277U/n3pRCGIvm/QvJLhYb9Oin9/II97Oi+9obwxYAYjBo/rYD3gUZd1ORNr8r3u3QfA3xuFbju+8ay37sEjqMffkNY9Ywb1uG93CEjaYlvrjNHVchyhTYDEhaQ2Jgl/Lr8FnXpjNrEF8SL/6hby0MpdpyXMaB2zDhqwQM3+0LoMDKff5uF6Xk4jxV9TZzH1ozPslWYZ/Qenv6ZCCLMHKNyK30xeiIys4fx8O6IwY6CuSXoB938AAAD//7lPNR0=" } diff --git a/metricbeat/module/kibana/stats/_meta/fields.yml b/metricbeat/module/kibana/stats/_meta/fields.yml index 58da702cc9fc..28889766ef2b 100644 --- a/metricbeat/module/kibana/stats/_meta/fields.yml +++ b/metricbeat/module/kibana/stats/_meta/fields.yml @@ -39,7 +39,7 @@ - name: concurrent_connections type: long description: > - Number of client connections made to the server. Note that browsers can send multiple simultaneous connections to request mulitple server assets at once, and they can re-use established connections. + Number of client connections made to the server. Note that browsers can send multiple simultaneous connections to request multiple server assets at once, and they can re-use established connections. - name: process type: group description: > From 37d4dcea498955e79aeaff7592d2dae94c562948 Mon Sep 17 00:00:00 2001 From: Steffen Siering Date: Tue, 24 Jul 2018 07:54:50 +0200 Subject: [PATCH 28/34] Update sarama (kafka client) to 1.17 (#7665) - Update Sarama to 1.17. The Sarama testsuite tests kafka versions between 0.11 and 1.1.0. - Update compatible versions in output docs - Add compression_level setting for gzip compression --- CHANGELOG.asciidoc | 2 +- NOTICE.txt | 6 +- auditbeat/auditbeat.reference.yml | 4 + filebeat/filebeat.reference.yml | 4 + heartbeat/heartbeat.reference.yml | 4 + libbeat/_meta/config.reference.yml | 4 + libbeat/docs/outputconfig.asciidoc | 14 +- libbeat/outputs/kafka/config.go | 70 ++++---- libbeat/outputs/kafka/version.go | 13 +- metricbeat/metricbeat.reference.yml | 4 + packetbeat/packetbeat.reference.yml | 4 + vendor/github.com/Shopify/sarama/CHANGELOG.md | 38 +++++ vendor/github.com/Shopify/sarama/LICENSE | 2 +- vendor/github.com/Shopify/sarama/Makefile | 5 +- vendor/github.com/Shopify/sarama/README.md | 2 +- vendor/github.com/Shopify/sarama/broker.go | 64 ++++++- vendor/github.com/Shopify/sarama/client.go | 96 ++++++++--- vendor/github.com/Shopify/sarama/config.go | 18 +- vendor/github.com/Shopify/sarama/consumer.go | 87 ++++------ .../sarama/consumer_metadata_request.go | 13 +- .../sarama/consumer_metadata_response.go | 48 +++--- .../Shopify/sarama/delete_groups_request.go | 30 ++++ .../Shopify/sarama/delete_groups_response.go | 70 ++++++++ .../Shopify/sarama/delete_records_request.go | 126 ++++++++++++++ .../Shopify/sarama/delete_records_response.go | 158 ++++++++++++++++++ .../Shopify/sarama/delete_topics_request.go | 11 +- vendor/github.com/Shopify/sarama/errors.go | 8 + .../Shopify/sarama/fetch_request.go | 2 +- .../Shopify/sarama/fetch_response.go | 8 +- .../sarama/find_coordinator_request.go | 61 +++++++ .../sarama/find_coordinator_response.go | 92 ++++++++++ .../Shopify/sarama/join_group_request.go | 24 ++- .../Shopify/sarama/join_group_response.go | 24 ++- vendor/github.com/Shopify/sarama/message.go | 37 +++- .../Shopify/sarama/metadata_request.go | 68 ++++++-- .../Shopify/sarama/metadata_response.go | 109 +++++++++--- .../Shopify/sarama/mockresponses.go | 71 +++++++- .../Shopify/sarama/offset_commit_request.go | 16 +- .../Shopify/sarama/offset_commit_response.go | 2 +- .../Shopify/sarama/offset_fetch_request.go | 2 +- .../Shopify/sarama/offset_fetch_response.go | 2 +- .../Shopify/sarama/offset_request.go | 2 +- .../Shopify/sarama/offset_response.go | 2 +- .../Shopify/sarama/produce_request.go | 8 +- .../Shopify/sarama/produce_response.go | 2 +- .../github.com/Shopify/sarama/produce_set.go | 41 +++-- .../github.com/Shopify/sarama/record_batch.go | 11 +- vendor/github.com/Shopify/sarama/records.go | 54 +++--- vendor/github.com/Shopify/sarama/request.go | 6 +- vendor/github.com/Shopify/sarama/utils.go | 54 ++++-- vendor/vendor.json | 8 +- winlogbeat/winlogbeat.reference.yml | 4 + 52 files changed, 1328 insertions(+), 287 deletions(-) create mode 100644 vendor/github.com/Shopify/sarama/delete_groups_request.go create mode 100644 vendor/github.com/Shopify/sarama/delete_groups_response.go create mode 100644 vendor/github.com/Shopify/sarama/delete_records_request.go create mode 100644 vendor/github.com/Shopify/sarama/delete_records_response.go create mode 100644 vendor/github.com/Shopify/sarama/find_coordinator_request.go create mode 100644 vendor/github.com/Shopify/sarama/find_coordinator_response.go diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index ca9a0f508039..9f658c7eb205 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -17,7 +17,7 @@ https://github.com/elastic/beats/compare/v6.2.3...master[Check the HEAD diff] - Rename beat.cpu.*.time metrics to beat.cpu.*.time.ms. {pull}6449[6449] - Mark `system.syslog.message` and `system.auth.message` as `text` instead of `keyword`. {pull}6589[6589] - Allow override of dynamic template `match_mapping_type` for fields with object_type. {pull}6691[6691] -- Set default kafka version to 1.0.0 in kafka output. Older versions are still supported by configuring the `version` setting. {pull}7025[7025] +- Set default kafka version to 1.0.0 in kafka output. Older versions are still supported by configuring the `version` setting. Minimally supported version is 0.11 (older versions might work, but are untested). {pull}7025[7025] - Add `host.name` field to all events, to avoid mapping conflicts. This could be breaking Logstash configs if you rely on the `host` field being a string. {pull}7051[7051] *Auditbeat* diff --git a/NOTICE.txt b/NOTICE.txt index 51c2164c2a64..2e926de1e3d5 100644 --- a/NOTICE.txt +++ b/NOTICE.txt @@ -2083,12 +2083,12 @@ THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. -------------------------------------------------------------------- Dependency: github.com/Shopify/sarama -Version: v1.16.0/enh/offset-replica-id -Revision: 32b4ad5c9537ed14e471779b76713ff65420db39 +Version: v1.17.0/enh/offset-replica-id +Revision: d1575e4abe04acbbe8ac766320585cdf271dd189 License type (autodetected): MIT ./vendor/github.com/Shopify/sarama/LICENSE: -------------------------------------------------------------------- -Copyright (c) 2013 Evan Huus +Copyright (c) 2013 Shopify Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the diff --git a/auditbeat/auditbeat.reference.yml b/auditbeat/auditbeat.reference.yml index d50360591271..7c15c6201d34 100644 --- a/auditbeat/auditbeat.reference.yml +++ b/auditbeat/auditbeat.reference.yml @@ -616,6 +616,10 @@ output.elasticsearch: # default is gzip. #compression: gzip + # Set the compression level. Currently only gzip provides a compression level + # between 0 and 9. The default value is chosen by the compression algorithm. + #compression_level: 4 + # The maximum permitted size of JSON-encoded messages. Bigger messages will be # dropped. The default value is 1000000 (bytes). This value should be equal to # or less than the broker's message.max.bytes. diff --git a/filebeat/filebeat.reference.yml b/filebeat/filebeat.reference.yml index 8d787d0f8afc..33d9d8bf1913 100644 --- a/filebeat/filebeat.reference.yml +++ b/filebeat/filebeat.reference.yml @@ -1276,6 +1276,10 @@ output.elasticsearch: # default is gzip. #compression: gzip + # Set the compression level. Currently only gzip provides a compression level + # between 0 and 9. The default value is chosen by the compression algorithm. + #compression_level: 4 + # The maximum permitted size of JSON-encoded messages. Bigger messages will be # dropped. The default value is 1000000 (bytes). This value should be equal to # or less than the broker's message.max.bytes. diff --git a/heartbeat/heartbeat.reference.yml b/heartbeat/heartbeat.reference.yml index df3f104751c8..56010ce9dc7f 100644 --- a/heartbeat/heartbeat.reference.yml +++ b/heartbeat/heartbeat.reference.yml @@ -723,6 +723,10 @@ output.elasticsearch: # default is gzip. #compression: gzip + # Set the compression level. Currently only gzip provides a compression level + # between 0 and 9. The default value is chosen by the compression algorithm. + #compression_level: 4 + # The maximum permitted size of JSON-encoded messages. Bigger messages will be # dropped. The default value is 1000000 (bytes). This value should be equal to # or less than the broker's message.max.bytes. diff --git a/libbeat/_meta/config.reference.yml b/libbeat/_meta/config.reference.yml index fc3bbd254c09..7f0d922a1484 100644 --- a/libbeat/_meta/config.reference.yml +++ b/libbeat/_meta/config.reference.yml @@ -509,6 +509,10 @@ output.elasticsearch: # default is gzip. #compression: gzip + # Set the compression level. Currently only gzip provides a compression level + # between 0 and 9. The default value is chosen by the compression algorithm. + #compression_level: 4 + # The maximum permitted size of JSON-encoded messages. Bigger messages will be # dropped. The default value is 1000000 (bytes). This value should be equal to # or less than the broker's message.max.bytes. diff --git a/libbeat/docs/outputconfig.asciidoc b/libbeat/docs/outputconfig.asciidoc index 90345342bee6..34e8b6b65940 100644 --- a/libbeat/docs/outputconfig.asciidoc +++ b/libbeat/docs/outputconfig.asciidoc @@ -667,7 +667,8 @@ NOTE: Events bigger than <> will be ==== Compatibility -This output works with Kafka 0.8, 0.9, and 0.10. +This output works with all Kafka in between 0.11 and 1.1.1. Older versions +might work as well, but are not supported. ==== Configuration options @@ -691,7 +692,7 @@ Kafka version ${beatname_lc} is assumed to run against. Defaults to 1.0.0. Event timestamps will be added, if version 0.10.0.0+ is enabled. -Valid values are all kafka releases in between `0.8.2.0` and `1.1.0`. +Valid values are all kafka releases in between `0.8.2.0` and `1.1.1`. ===== `username` @@ -833,6 +834,15 @@ The keep-alive period for an active network connection. If 0s, keep-alives are d Sets the output compression codec. Must be one of `none`, `snappy`, `lz4` and `gzip`. The default is `gzip`. +===== `compression_level` + +Sets the compression level used by gzip. Setting this value to 0 disables compression. +The compression level must be in the range of 1 (best speed) to 9 (best compression). + +Increasing the compression level will reduce the network usage but will increase the cpu usage. + +The default value is 4. + [[kafka-max_message_bytes]] ===== `max_message_bytes` diff --git a/libbeat/outputs/kafka/config.go b/libbeat/outputs/kafka/config.go index 2e9a0152d1fc..956a8bd8cb4b 100644 --- a/libbeat/outputs/kafka/config.go +++ b/libbeat/outputs/kafka/config.go @@ -36,25 +36,26 @@ import ( ) type kafkaConfig struct { - Hosts []string `config:"hosts" validate:"required"` - TLS *tlscommon.Config `config:"ssl"` - Timeout time.Duration `config:"timeout" validate:"min=1"` - Metadata metaConfig `config:"metadata"` - Key *fmtstr.EventFormatString `config:"key"` - Partition map[string]*common.Config `config:"partition"` - KeepAlive time.Duration `config:"keep_alive" validate:"min=0"` - MaxMessageBytes *int `config:"max_message_bytes" validate:"min=1"` - RequiredACKs *int `config:"required_acks" validate:"min=-1"` - BrokerTimeout time.Duration `config:"broker_timeout" validate:"min=1"` - Compression string `config:"compression"` - Version string `config:"version"` - BulkMaxSize int `config:"bulk_max_size"` - MaxRetries int `config:"max_retries" validate:"min=-1,nonzero"` - ClientID string `config:"client_id"` - ChanBufferSize int `config:"channel_buffer_size" validate:"min=1"` - Username string `config:"username"` - Password string `config:"password"` - Codec codec.Config `config:"codec"` + Hosts []string `config:"hosts" validate:"required"` + TLS *tlscommon.Config `config:"ssl"` + Timeout time.Duration `config:"timeout" validate:"min=1"` + Metadata metaConfig `config:"metadata"` + Key *fmtstr.EventFormatString `config:"key"` + Partition map[string]*common.Config `config:"partition"` + KeepAlive time.Duration `config:"keep_alive" validate:"min=0"` + MaxMessageBytes *int `config:"max_message_bytes" validate:"min=1"` + RequiredACKs *int `config:"required_acks" validate:"min=-1"` + BrokerTimeout time.Duration `config:"broker_timeout" validate:"min=1"` + Compression string `config:"compression"` + CompressionLevel int `config:"compression_level"` + Version string `config:"version"` + BulkMaxSize int `config:"bulk_max_size"` + MaxRetries int `config:"max_retries" validate:"min=-1,nonzero"` + ClientID string `config:"client_id"` + ChanBufferSize int `config:"channel_buffer_size" validate:"min=1"` + Username string `config:"username"` + Password string `config:"password"` + Codec codec.Config `config:"codec"` } type metaConfig struct { @@ -89,17 +90,18 @@ func defaultConfig() kafkaConfig { }, RefreshFreq: 10 * time.Minute, }, - KeepAlive: 0, - MaxMessageBytes: nil, // use library default - RequiredACKs: nil, // use library default - BrokerTimeout: 10 * time.Second, - Compression: "gzip", - Version: "1.0.0", - MaxRetries: 3, - ClientID: "beats", - ChanBufferSize: 256, - Username: "", - Password: "", + KeepAlive: 0, + MaxMessageBytes: nil, // use library default + RequiredACKs: nil, // use library default + BrokerTimeout: 10 * time.Second, + Compression: "gzip", + CompressionLevel: 4, + Version: "1.0.0", + MaxRetries: 3, + ClientID: "beats", + ChanBufferSize: 256, + Username: "", + Password: "", } } @@ -120,6 +122,13 @@ func (c *kafkaConfig) Validate() error { return fmt.Errorf("password must be set when username is configured") } + if c.Compression == "gzip" { + lvl := c.CompressionLevel + if lvl != sarama.CompressionLevelDefault && !(0 <= lvl && lvl <= 9) { + return fmt.Errorf("compression_level must be between 0 and 9") + } + } + return nil } @@ -138,6 +147,7 @@ func newSaramaConfig(config *kafkaConfig) (*sarama.Config, error) { k.Net.WriteTimeout = timeout k.Net.KeepAlive = config.KeepAlive k.Producer.Timeout = config.BrokerTimeout + k.Producer.CompressionLevel = config.CompressionLevel tls, err := outputs.LoadTLSConfig(config.TLS) if err != nil { diff --git a/libbeat/outputs/kafka/version.go b/libbeat/outputs/kafka/version.go index d171520a10c5..884e67616a20 100644 --- a/libbeat/outputs/kafka/version.go +++ b/libbeat/outputs/kafka/version.go @@ -27,7 +27,8 @@ var ( v0_11_0_1 = parseKafkaVersion("0.11.0.1") v0_11_0_2 = parseKafkaVersion("0.11.0.2") v1_0_1 = parseKafkaVersion("1.0.1") - v1_1_0 = parseKafkaVersion("1.1.0") + v1_0_2 = parseKafkaVersion("1.0.2") + v1_1_1 = parseKafkaVersion("1.1.1") kafkaVersions = map[string]sarama.KafkaVersion{ "": sarama.V1_0_0_0, @@ -61,10 +62,12 @@ var ( "1.0.0": sarama.V1_0_0_0, "1.0.1": v1_0_1, - "1.0": v1_0_1, - "1.1.0": v1_1_0, - "1.1": v1_1_0, - "1": v1_1_0, + "1.0.2": v1_0_2, + "1.0": v1_0_2, + "1.1.0": sarama.V1_1_0_0, + "1.1.1": v1_1_1, + "1.1": v1_1_1, + "1": v1_1_1, } ) diff --git a/metricbeat/metricbeat.reference.yml b/metricbeat/metricbeat.reference.yml index 4acd3a0ffb30..9e041845053d 100644 --- a/metricbeat/metricbeat.reference.yml +++ b/metricbeat/metricbeat.reference.yml @@ -1177,6 +1177,10 @@ output.elasticsearch: # default is gzip. #compression: gzip + # Set the compression level. Currently only gzip provides a compression level + # between 0 and 9. The default value is chosen by the compression algorithm. + #compression_level: 4 + # The maximum permitted size of JSON-encoded messages. Bigger messages will be # dropped. The default value is 1000000 (bytes). This value should be equal to # or less than the broker's message.max.bytes. diff --git a/packetbeat/packetbeat.reference.yml b/packetbeat/packetbeat.reference.yml index a63b78007b8c..031ee795441f 100644 --- a/packetbeat/packetbeat.reference.yml +++ b/packetbeat/packetbeat.reference.yml @@ -986,6 +986,10 @@ output.elasticsearch: # default is gzip. #compression: gzip + # Set the compression level. Currently only gzip provides a compression level + # between 0 and 9. The default value is chosen by the compression algorithm. + #compression_level: 4 + # The maximum permitted size of JSON-encoded messages. Bigger messages will be # dropped. The default value is 1000000 (bytes). This value should be equal to # or less than the broker's message.max.bytes. diff --git a/vendor/github.com/Shopify/sarama/CHANGELOG.md b/vendor/github.com/Shopify/sarama/CHANGELOG.md index 836841650c3d..16d5829c9953 100644 --- a/vendor/github.com/Shopify/sarama/CHANGELOG.md +++ b/vendor/github.com/Shopify/sarama/CHANGELOG.md @@ -1,5 +1,43 @@ # Changelog +#### Version 1.17.0 (2018-05-30) + +New Features: + - Add support for gzip compression levels + ([#1044](https://github.com/Shopify/sarama/pull/1044)). + - Add support for Metadata request/response pairs versions v1 to v5 + ([#1047](https://github.com/Shopify/sarama/pull/1047), + [#1069](https://github.com/Shopify/sarama/pull/1069)). + - Add versioning to JoinGroup request/response pairs + ([#1098](https://github.com/Shopify/sarama/pull/1098)) + - Add support for CreatePartitions, DeleteGroups, DeleteRecords request/response pairs + ([#1065](https://github.com/Shopify/sarama/pull/1065), + [#1096](https://github.com/Shopify/sarama/pull/1096), + [#1027](https://github.com/Shopify/sarama/pull/1027)). + - Add `Controller()` method to Client interface + ([#1063](https://github.com/Shopify/sarama/pull/1063)). + +Improvements: + - ConsumerMetadataReq/Resp has been migrated to FindCoordinatorReq/Resp + ([#1010](https://github.com/Shopify/sarama/pull/1010)). + - Expose missing protocol parts: `msgSet` and `recordBatch` + ([#1049](https://github.com/Shopify/sarama/pull/1049)). + - Add support for v1 DeleteTopics Request + ([#1052](https://github.com/Shopify/sarama/pull/1052)). + - Add support for Go 1.10 + ([#1064](https://github.com/Shopify/sarama/pull/1064)). + - Claim support for Kafka 1.1.0 + ([#1073](https://github.com/Shopify/sarama/pull/1073)). + +Bug Fixes: + - Fix FindCoordinatorResponse.encode to allow nil Coordinator + ([#1050](https://github.com/Shopify/sarama/pull/1050), + [#1051](https://github.com/Shopify/sarama/pull/1051)). + - Clear all metadata when we have the latest topic info + ([#1033](https://github.com/Shopify/sarama/pull/1033)). + - Make `PartitionConsumer.Close` idempotent + ([#1092](https://github.com/Shopify/sarama/pull/1092)). + #### Version 1.16.0 (2018-02-12) New Features: diff --git a/vendor/github.com/Shopify/sarama/LICENSE b/vendor/github.com/Shopify/sarama/LICENSE index 8121b63b1c4a..d2bf4352f4c9 100644 --- a/vendor/github.com/Shopify/sarama/LICENSE +++ b/vendor/github.com/Shopify/sarama/LICENSE @@ -1,4 +1,4 @@ -Copyright (c) 2013 Evan Huus +Copyright (c) 2013 Shopify Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the diff --git a/vendor/github.com/Shopify/sarama/Makefile b/vendor/github.com/Shopify/sarama/Makefile index 58a39e4f34dd..b9a453dd29c6 100644 --- a/vendor/github.com/Shopify/sarama/Makefile +++ b/vendor/github.com/Shopify/sarama/Makefile @@ -4,7 +4,7 @@ default: fmt vet errcheck test test: echo "" > coverage.txt for d in `go list ./... | grep -v vendor`; do \ - go test -v -timeout 60s -race -coverprofile=profile.out -covermode=atomic $$d; \ + go test -p 1 -v -timeout 90s -race -coverprofile=profile.out -covermode=atomic $$d || exit 1; \ if [ -f profile.out ]; then \ cat profile.out >> coverage.txt; \ rm profile.out; \ @@ -14,8 +14,9 @@ test: vet: go vet ./... +# See https://github.com/kisielk/errcheck/pull/141 for details on ignorepkg errcheck: - errcheck github.com/Shopify/sarama/... + errcheck -ignorepkg fmt github.com/Shopify/sarama/... fmt: @if [ -n "$$(go fmt ./...)" ]; then echo 'Please run go fmt on your code.' && exit 1; fi diff --git a/vendor/github.com/Shopify/sarama/README.md b/vendor/github.com/Shopify/sarama/README.md index 28431f13eb8f..4fc0cc600f86 100644 --- a/vendor/github.com/Shopify/sarama/README.md +++ b/vendor/github.com/Shopify/sarama/README.md @@ -21,7 +21,7 @@ You might also want to look at the [Frequently Asked Questions](https://github.c Sarama provides a "2 releases + 2 months" compatibility guarantee: we support the two latest stable releases of Kafka and Go, and we provide a two month grace period for older releases. This means we currently officially support -Go 1.9 and 1.8, and Kafka 1.0 through 0.10, although older releases are +Go 1.8 through 1.10, and Kafka 0.11 through 1.1, although older releases are still likely to work. Sarama follows semantic versioning and provides API stability via the gopkg.in service. diff --git a/vendor/github.com/Shopify/sarama/broker.go b/vendor/github.com/Shopify/sarama/broker.go index b759f8f7841c..d836bee6d86a 100644 --- a/vendor/github.com/Shopify/sarama/broker.go +++ b/vendor/github.com/Shopify/sarama/broker.go @@ -18,6 +18,7 @@ import ( type Broker struct { id int32 addr string + rack *string conf *Config correlationID int32 @@ -230,6 +231,18 @@ func (b *Broker) GetConsumerMetadata(request *ConsumerMetadataRequest) (*Consume return response, nil } +func (b *Broker) FindCoordinator(request *FindCoordinatorRequest) (*FindCoordinatorResponse, error) { + response := new(FindCoordinatorResponse) + + err := b.sendAndReceive(request, response) + + if err != nil { + return nil, err + } + + return response, nil +} + func (b *Broker) GetAvailableOffsets(request *OffsetRequest) (*OffsetResponse, error) { response := new(OffsetResponse) @@ -373,6 +386,17 @@ func (b *Broker) ApiVersions(request *ApiVersionsRequest) (*ApiVersionsResponse, return response, nil } +func (b *Broker) CreatePartitions(request *CreatePartitionsRequest) (*CreatePartitionsResponse, error) { + response := new(CreatePartitionsResponse) + + err := b.sendAndReceive(request, response) + if err != nil { + return nil, err + } + + return response, nil +} + func (b *Broker) CreateTopics(request *CreateTopicsRequest) (*CreateTopicsResponse, error) { response := new(CreateTopicsResponse) @@ -395,6 +419,17 @@ func (b *Broker) DeleteTopics(request *DeleteTopicsRequest) (*DeleteTopicsRespon return response, nil } +func (b *Broker) DeleteRecords(request *DeleteRecordsRequest) (*DeleteRecordsResponse, error) { + response := new(DeleteRecordsResponse) + + err := b.sendAndReceive(request, response) + if err != nil { + return nil, err + } + + return response, nil +} + func (b *Broker) DescribeAcls(request *DescribeAclsRequest) (*DescribeAclsResponse, error) { response := new(DescribeAclsResponse) @@ -504,6 +539,17 @@ func (b *Broker) AlterConfigs(request *AlterConfigsRequest) (*AlterConfigsRespon return response, nil } + +func (b *Broker) DeleteGroups(request *DeleteGroupsRequest) (*DeleteGroupsResponse, error) { + response := new(DeleteGroupsResponse) + + if err := b.sendAndReceive(request, response); err != nil { + return nil, err + } + + return response, nil +} + func (b *Broker) send(rb protocolBody, promiseResponse bool) (*responsePromise, error) { b.lock.Lock() defer b.lock.Unlock() @@ -569,7 +615,7 @@ func (b *Broker) sendAndReceive(req protocolBody, res versionedDecoder) error { } } -func (b *Broker) decode(pd packetDecoder) (err error) { +func (b *Broker) decode(pd packetDecoder, version int16) (err error) { b.id, err = pd.getInt32() if err != nil { return err @@ -585,6 +631,13 @@ func (b *Broker) decode(pd packetDecoder) (err error) { return err } + if version >= 1 { + b.rack, err = pd.getNullableString() + if err != nil { + return err + } + } + b.addr = net.JoinHostPort(host, fmt.Sprint(port)) if _, _, err := net.SplitHostPort(b.addr); err != nil { return err @@ -593,7 +646,7 @@ func (b *Broker) decode(pd packetDecoder) (err error) { return nil } -func (b *Broker) encode(pe packetEncoder) (err error) { +func (b *Broker) encode(pe packetEncoder, version int16) (err error) { host, portstr, err := net.SplitHostPort(b.addr) if err != nil { @@ -613,6 +666,13 @@ func (b *Broker) encode(pe packetEncoder) (err error) { pe.putInt32(int32(port)) + if version >= 1 { + err = pe.putNullableString(b.rack) + if err != nil { + return err + } + } + return nil } diff --git a/vendor/github.com/Shopify/sarama/client.go b/vendor/github.com/Shopify/sarama/client.go index 3dbfc4b06ffb..019cb43735ae 100644 --- a/vendor/github.com/Shopify/sarama/client.go +++ b/vendor/github.com/Shopify/sarama/client.go @@ -17,6 +17,9 @@ type Client interface { // altered after it has been created. Config() *Config + // Controller returns the cluster controller broker. + Controller() (*Broker, error) + // Brokers returns the current set of active brokers as retrieved from cluster metadata. Brokers() []*Broker @@ -97,6 +100,7 @@ type client struct { seedBrokers []*Broker deadSeeds []*Broker + controllerID int32 // cluster controller broker id brokers map[int32]*Broker // maps broker ids to brokers metadata map[string]map[int32]*PartitionMetadata // maps topics to partition ids to metadata coordinators map[string]int32 // Maps consumer group names to coordinating broker IDs @@ -379,6 +383,27 @@ func (client *client) GetOffset(topic string, partitionID int32, time int64) (in return offset, err } +func (client *client) Controller() (*Broker, error) { + if client.Closed() { + return nil, ErrClosedClient + } + + controller := client.cachedController() + if controller == nil { + if err := client.refreshMetadata(); err != nil { + return nil, err + } + controller = client.cachedController() + } + + if controller == nil { + return nil, ErrControllerNotAvailable + } + + _ = controller.Open(client.conf) + return controller, nil +} + func (client *client) Coordinator(consumerGroup string) (*Broker, error) { if client.Closed() { return nil, ErrClosedClient @@ -607,20 +632,7 @@ func (client *client) backgroundMetadataUpdater() { for { select { case <-ticker.C: - topics := []string{} - if !client.conf.Metadata.Full { - if specificTopics, err := client.Topics(); err != nil { - Logger.Println("Client background metadata topic load:", err) - break - } else if len(specificTopics) == 0 { - Logger.Println("Client background metadata update: no specific topics to update") - break - } else { - topics = specificTopics - } - } - - if err := client.RefreshMetadata(topics...); err != nil { + if err := client.refreshMetadata(); err != nil { Logger.Println("Client background metadata update:", err) } case <-client.closer: @@ -629,6 +641,26 @@ func (client *client) backgroundMetadataUpdater() { } } +func (client *client) refreshMetadata() error { + topics := []string{} + + if !client.conf.Metadata.Full { + if specificTopics, err := client.Topics(); err != nil { + return err + } else if len(specificTopics) == 0 { + return ErrNoTopicsToUpdateMetadata + } else { + topics = specificTopics + } + } + + if err := client.RefreshMetadata(topics...); err != nil { + return err + } + + return nil +} + func (client *client) tryRefreshMetadata(topics []string, attemptsRemaining int) error { retry := func(err error) error { if attemptsRemaining > 0 { @@ -645,12 +677,18 @@ func (client *client) tryRefreshMetadata(topics []string, attemptsRemaining int) } else { Logger.Printf("client/metadata fetching metadata for all topics from broker %s\n", broker.addr) } - response, err := broker.GetMetadata(&MetadataRequest{Topics: topics}) + + req := &MetadataRequest{Topics: topics} + if client.conf.Version.IsAtLeast(V0_10_0_0) { + req.Version = 1 + } + response, err := broker.GetMetadata(req) switch err.(type) { case nil: + allKnownMetaData := len(topics) == 0 // valid response, use it - shouldRetry, err := client.updateMetadata(response) + shouldRetry, err := client.updateMetadata(response, allKnownMetaData) if shouldRetry { Logger.Println("client/metadata found some partitions to be leaderless") return retry(err) // note: err can be nil @@ -674,7 +712,7 @@ func (client *client) tryRefreshMetadata(topics []string, attemptsRemaining int) } // if no fatal error, returns a list of topics that need retrying due to ErrLeaderNotAvailable -func (client *client) updateMetadata(data *MetadataResponse) (retry bool, err error) { +func (client *client) updateMetadata(data *MetadataResponse, allKnownMetaData bool) (retry bool, err error) { client.lock.Lock() defer client.lock.Unlock() @@ -686,6 +724,12 @@ func (client *client) updateMetadata(data *MetadataResponse) (retry bool, err er client.registerBroker(broker) } + client.controllerID = data.ControllerID + + if allKnownMetaData { + client.metadata = make(map[string]map[int32]*PartitionMetadata) + client.cachedPartitionsResults = make(map[string][maxPartitionIndex][]int32) + } for _, topic := range data.Topics { delete(client.metadata, topic.Name) delete(client.cachedPartitionsResults, topic.Name) @@ -735,8 +779,15 @@ func (client *client) cachedCoordinator(consumerGroup string) *Broker { return nil } -func (client *client) getConsumerMetadata(consumerGroup string, attemptsRemaining int) (*ConsumerMetadataResponse, error) { - retry := func(err error) (*ConsumerMetadataResponse, error) { +func (client *client) cachedController() *Broker { + client.lock.RLock() + defer client.lock.RUnlock() + + return client.brokers[client.controllerID] +} + +func (client *client) getConsumerMetadata(consumerGroup string, attemptsRemaining int) (*FindCoordinatorResponse, error) { + retry := func(err error) (*FindCoordinatorResponse, error) { if attemptsRemaining > 0 { Logger.Printf("client/coordinator retrying after %dms... (%d attempts remaining)\n", client.conf.Metadata.Retry.Backoff/time.Millisecond, attemptsRemaining) time.Sleep(client.conf.Metadata.Retry.Backoff) @@ -748,10 +799,11 @@ func (client *client) getConsumerMetadata(consumerGroup string, attemptsRemainin for broker := client.any(); broker != nil; broker = client.any() { Logger.Printf("client/coordinator requesting coordinator for consumergroup %s from %s\n", consumerGroup, broker.Addr()) - request := new(ConsumerMetadataRequest) - request.ConsumerGroup = consumerGroup + request := new(FindCoordinatorRequest) + request.CoordinatorKey = consumerGroup + request.CoordinatorType = CoordinatorGroup - response, err := broker.GetConsumerMetadata(request) + response, err := broker.FindCoordinator(request) if err != nil { Logger.Printf("client/coordinator request to broker %s failed: %s\n", broker.Addr(), err) diff --git a/vendor/github.com/Shopify/sarama/config.go b/vendor/github.com/Shopify/sarama/config.go index 29ea5c2b36e0..a564b5c23e4b 100644 --- a/vendor/github.com/Shopify/sarama/config.go +++ b/vendor/github.com/Shopify/sarama/config.go @@ -1,7 +1,10 @@ package sarama import ( + "compress/gzip" "crypto/tls" + "fmt" + "io/ioutil" "regexp" "time" @@ -99,6 +102,10 @@ type Config struct { // The type of compression to use on messages (defaults to no compression). // Similar to `compression.codec` setting of the JVM producer. Compression CompressionCodec + // The level of compression to use on messages. The meaning depends + // on the actual compression type used and defaults to default compression + // level for the codec. + CompressionLevel int // Generates partitioners for choosing the partition to send messages to // (defaults to hashing the message key). Similar to the `partitioner.class` // setting for the JVM producer. @@ -290,6 +297,7 @@ func NewConfig() *Config { c.Producer.Retry.Max = 3 c.Producer.Retry.Backoff = 100 * time.Millisecond c.Producer.Return.Errors = true + c.Producer.CompressionLevel = CompressionLevelDefault c.Consumer.Fetch.Min = 1 c.Consumer.Fetch.Default = 1024 * 1024 @@ -302,7 +310,7 @@ func NewConfig() *Config { c.ClientID = defaultClientID c.ChannelBufferSize = 256 - c.Version = minVersion + c.Version = MinVersion c.MetricRegistry = metrics.NewRegistry() return c @@ -409,6 +417,14 @@ func (c *Config) Validate() error { return ConfigurationError("lz4 compression requires Version >= V0_10_0_0") } + if c.Producer.Compression == CompressionGZIP { + if c.Producer.CompressionLevel != CompressionLevelDefault { + if _, err := gzip.NewWriterLevel(ioutil.Discard, c.Producer.CompressionLevel); err != nil { + return ConfigurationError(fmt.Sprintf("gzip compression does not work with level %d: %v", c.Producer.CompressionLevel, err)) + } + } + } + // validate the Consumer values switch { case c.Consumer.Fetch.Min <= 0: diff --git a/vendor/github.com/Shopify/sarama/consumer.go b/vendor/github.com/Shopify/sarama/consumer.go index 48d231cf9844..96226ac5bf52 100644 --- a/vendor/github.com/Shopify/sarama/consumer.go +++ b/vendor/github.com/Shopify/sarama/consumer.go @@ -310,6 +310,7 @@ type partitionConsumer struct { trigger, dying chan none responseResult error + closeOnce sync.Once fetchSize int32 offset int64 @@ -412,7 +413,9 @@ func (child *partitionConsumer) AsyncClose() { // the dispatcher to exit its loop, which removes it from the consumer then closes its 'messages' and // 'errors' channel (alternatively, if the child is already at the dispatcher for some reason, that will // also just close itself) - close(child.dying) + child.closeOnce.Do(func() { + close(child.dying) + }) } func (child *partitionConsumer) Close() error { @@ -461,7 +464,6 @@ feederLoop: child.messages <- msg } child.broker.input <- child - expiryTicker.Stop() continue feederLoop } else { // current message has not been sent, return to select @@ -482,9 +484,6 @@ feederLoop: func (child *partitionConsumer) parseMessages(msgSet *MessageSet) ([]*ConsumerMessage, error) { var messages []*ConsumerMessage - var incomplete bool - prelude := true - for _, msgBlock := range msgSet.Messages { for _, msg := range msgBlock.Messages() { offset := msg.Offset @@ -492,29 +491,22 @@ func (child *partitionConsumer) parseMessages(msgSet *MessageSet) ([]*ConsumerMe baseOffset := msgBlock.Offset - msgBlock.Messages()[len(msgBlock.Messages())-1].Offset offset += baseOffset } - if prelude && offset < child.offset { + if offset < child.offset { continue } - prelude = false - - if offset >= child.offset { - messages = append(messages, &ConsumerMessage{ - Topic: child.topic, - Partition: child.partition, - Key: msg.Msg.Key, - Value: msg.Msg.Value, - Offset: offset, - Timestamp: msg.Msg.Timestamp, - BlockTimestamp: msgBlock.Msg.Timestamp, - }) - child.offset = offset + 1 - } else { - incomplete = true - } + messages = append(messages, &ConsumerMessage{ + Topic: child.topic, + Partition: child.partition, + Key: msg.Msg.Key, + Value: msg.Msg.Value, + Offset: offset, + Timestamp: msg.Msg.Timestamp, + BlockTimestamp: msgBlock.Msg.Timestamp, + }) + child.offset = offset + 1 } } - - if incomplete || len(messages) == 0 { + if len(messages) == 0 { return nil, ErrIncompleteResponse } return messages, nil @@ -522,42 +514,25 @@ func (child *partitionConsumer) parseMessages(msgSet *MessageSet) ([]*ConsumerMe func (child *partitionConsumer) parseRecords(batch *RecordBatch) ([]*ConsumerMessage, error) { var messages []*ConsumerMessage - var incomplete bool - prelude := true - originalOffset := child.offset - for _, rec := range batch.Records { offset := batch.FirstOffset + rec.OffsetDelta - if prelude && offset < child.offset { + if offset < child.offset { continue } - prelude = false - - if offset >= child.offset { - messages = append(messages, &ConsumerMessage{ - Topic: child.topic, - Partition: child.partition, - Key: rec.Key, - Value: rec.Value, - Offset: offset, - Timestamp: batch.FirstTimestamp.Add(rec.TimestampDelta), - Headers: rec.Headers, - }) - child.offset = offset + 1 - } else { - incomplete = true - } - } - - if incomplete { + messages = append(messages, &ConsumerMessage{ + Topic: child.topic, + Partition: child.partition, + Key: rec.Key, + Value: rec.Value, + Offset: offset, + Timestamp: batch.FirstTimestamp.Add(rec.TimestampDelta), + Headers: rec.Headers, + }) + child.offset = offset + 1 + } + if len(messages) == 0 { return nil, ErrIncompleteResponse } - - child.offset = batch.FirstOffset + int64(batch.LastOffsetDelta) + 1 - if child.offset <= originalOffset { - return nil, ErrConsumerOffsetNotAdvanced - } - return messages, nil } @@ -610,14 +585,14 @@ func (child *partitionConsumer) parseResponse(response *FetchResponse) ([]*Consu switch records.recordsType { case legacyRecords: - messageSetMessages, err := child.parseMessages(records.msgSet) + messageSetMessages, err := child.parseMessages(records.MsgSet) if err != nil { return nil, err } messages = append(messages, messageSetMessages...) case defaultRecords: - recordBatchMessages, err := child.parseRecords(records.recordBatch) + recordBatchMessages, err := child.parseRecords(records.RecordBatch) if err != nil { return nil, err } diff --git a/vendor/github.com/Shopify/sarama/consumer_metadata_request.go b/vendor/github.com/Shopify/sarama/consumer_metadata_request.go index 483be3354df5..4de45e7bf50b 100644 --- a/vendor/github.com/Shopify/sarama/consumer_metadata_request.go +++ b/vendor/github.com/Shopify/sarama/consumer_metadata_request.go @@ -5,12 +5,19 @@ type ConsumerMetadataRequest struct { } func (r *ConsumerMetadataRequest) encode(pe packetEncoder) error { - return pe.putString(r.ConsumerGroup) + tmp := new(FindCoordinatorRequest) + tmp.CoordinatorKey = r.ConsumerGroup + tmp.CoordinatorType = CoordinatorGroup + return tmp.encode(pe) } func (r *ConsumerMetadataRequest) decode(pd packetDecoder, version int16) (err error) { - r.ConsumerGroup, err = pd.getString() - return err + tmp := new(FindCoordinatorRequest) + if err := tmp.decode(pd, version); err != nil { + return err + } + r.ConsumerGroup = tmp.CoordinatorKey + return nil } func (r *ConsumerMetadataRequest) key() int16 { diff --git a/vendor/github.com/Shopify/sarama/consumer_metadata_response.go b/vendor/github.com/Shopify/sarama/consumer_metadata_response.go index 6b9632bbafe6..442cbde7ac00 100644 --- a/vendor/github.com/Shopify/sarama/consumer_metadata_response.go +++ b/vendor/github.com/Shopify/sarama/consumer_metadata_response.go @@ -14,20 +14,18 @@ type ConsumerMetadataResponse struct { } func (r *ConsumerMetadataResponse) decode(pd packetDecoder, version int16) (err error) { - tmp, err := pd.getInt16() - if err != nil { - return err - } - r.Err = KError(tmp) + tmp := new(FindCoordinatorResponse) - coordinator := new(Broker) - if err := coordinator.decode(pd); err != nil { + if err := tmp.decode(pd, version); err != nil { return err } - if coordinator.addr == ":0" { + + r.Err = tmp.Err + + r.Coordinator = tmp.Coordinator + if tmp.Coordinator == nil { return nil } - r.Coordinator = coordinator // this can all go away in 2.0, but we have to fill in deprecated fields to maintain // backwards compatibility @@ -47,28 +45,22 @@ func (r *ConsumerMetadataResponse) decode(pd packetDecoder, version int16) (err } func (r *ConsumerMetadataResponse) encode(pe packetEncoder) error { - pe.putInt16(int16(r.Err)) - if r.Coordinator != nil { - host, portstr, err := net.SplitHostPort(r.Coordinator.Addr()) - if err != nil { - return err - } - port, err := strconv.ParseInt(portstr, 10, 32) - if err != nil { - return err - } - pe.putInt32(r.Coordinator.ID()) - if err := pe.putString(host); err != nil { - return err - } - pe.putInt32(int32(port)) - return nil + if r.Coordinator == nil { + r.Coordinator = new(Broker) + r.Coordinator.id = r.CoordinatorID + r.Coordinator.addr = net.JoinHostPort(r.CoordinatorHost, strconv.Itoa(int(r.CoordinatorPort))) + } + + tmp := &FindCoordinatorResponse{ + Version: 0, + Err: r.Err, + Coordinator: r.Coordinator, } - pe.putInt32(r.CoordinatorID) - if err := pe.putString(r.CoordinatorHost); err != nil { + + if err := tmp.encode(pe); err != nil { return err } - pe.putInt32(r.CoordinatorPort) + return nil } diff --git a/vendor/github.com/Shopify/sarama/delete_groups_request.go b/vendor/github.com/Shopify/sarama/delete_groups_request.go new file mode 100644 index 000000000000..305a324ac2d5 --- /dev/null +++ b/vendor/github.com/Shopify/sarama/delete_groups_request.go @@ -0,0 +1,30 @@ +package sarama + +type DeleteGroupsRequest struct { + Groups []string +} + +func (r *DeleteGroupsRequest) encode(pe packetEncoder) error { + return pe.putStringArray(r.Groups) +} + +func (r *DeleteGroupsRequest) decode(pd packetDecoder, version int16) (err error) { + r.Groups, err = pd.getStringArray() + return +} + +func (r *DeleteGroupsRequest) key() int16 { + return 42 +} + +func (r *DeleteGroupsRequest) version() int16 { + return 0 +} + +func (r *DeleteGroupsRequest) requiredVersion() KafkaVersion { + return V1_1_0_0 +} + +func (r *DeleteGroupsRequest) AddGroup(group string) { + r.Groups = append(r.Groups, group) +} diff --git a/vendor/github.com/Shopify/sarama/delete_groups_response.go b/vendor/github.com/Shopify/sarama/delete_groups_response.go new file mode 100644 index 000000000000..c067ebb42b03 --- /dev/null +++ b/vendor/github.com/Shopify/sarama/delete_groups_response.go @@ -0,0 +1,70 @@ +package sarama + +import ( + "time" +) + +type DeleteGroupsResponse struct { + ThrottleTime time.Duration + GroupErrorCodes map[string]KError +} + +func (r *DeleteGroupsResponse) encode(pe packetEncoder) error { + pe.putInt32(int32(r.ThrottleTime / time.Millisecond)) + + if err := pe.putArrayLength(len(r.GroupErrorCodes)); err != nil { + return err + } + for groupID, errorCode := range r.GroupErrorCodes { + if err := pe.putString(groupID); err != nil { + return err + } + pe.putInt16(int16(errorCode)) + } + + return nil +} + +func (r *DeleteGroupsResponse) decode(pd packetDecoder, version int16) error { + throttleTime, err := pd.getInt32() + if err != nil { + return err + } + r.ThrottleTime = time.Duration(throttleTime) * time.Millisecond + + n, err := pd.getArrayLength() + if err != nil { + return err + } + if n == 0 { + return nil + } + + r.GroupErrorCodes = make(map[string]KError, n) + for i := 0; i < n; i++ { + groupID, err := pd.getString() + if err != nil { + return err + } + errorCode, err := pd.getInt16() + if err != nil { + return err + } + + r.GroupErrorCodes[groupID] = KError(errorCode) + } + + return nil +} + +func (r *DeleteGroupsResponse) key() int16 { + return 42 +} + +func (r *DeleteGroupsResponse) version() int16 { + return 0 +} + +func (r *DeleteGroupsResponse) requiredVersion() KafkaVersion { + return V1_1_0_0 +} diff --git a/vendor/github.com/Shopify/sarama/delete_records_request.go b/vendor/github.com/Shopify/sarama/delete_records_request.go new file mode 100644 index 000000000000..93efafd4d0b8 --- /dev/null +++ b/vendor/github.com/Shopify/sarama/delete_records_request.go @@ -0,0 +1,126 @@ +package sarama + +import ( + "sort" + "time" +) + +// request message format is: +// [topic] timeout(int32) +// where topic is: +// name(string) [partition] +// where partition is: +// id(int32) offset(int64) + +type DeleteRecordsRequest struct { + Topics map[string]*DeleteRecordsRequestTopic + Timeout time.Duration +} + +func (d *DeleteRecordsRequest) encode(pe packetEncoder) error { + if err := pe.putArrayLength(len(d.Topics)); err != nil { + return err + } + keys := make([]string, 0, len(d.Topics)) + for topic := range d.Topics { + keys = append(keys, topic) + } + sort.Strings(keys) + for _, topic := range keys { + if err := pe.putString(topic); err != nil { + return err + } + if err := d.Topics[topic].encode(pe); err != nil { + return err + } + } + pe.putInt32(int32(d.Timeout / time.Millisecond)) + + return nil +} + +func (d *DeleteRecordsRequest) decode(pd packetDecoder, version int16) error { + n, err := pd.getArrayLength() + if err != nil { + return err + } + + if n > 0 { + d.Topics = make(map[string]*DeleteRecordsRequestTopic, n) + for i := 0; i < n; i++ { + topic, err := pd.getString() + if err != nil { + return err + } + details := new(DeleteRecordsRequestTopic) + if err = details.decode(pd, version); err != nil { + return err + } + d.Topics[topic] = details + } + } + + timeout, err := pd.getInt32() + if err != nil { + return err + } + d.Timeout = time.Duration(timeout) * time.Millisecond + + return nil +} + +func (d *DeleteRecordsRequest) key() int16 { + return 21 +} + +func (d *DeleteRecordsRequest) version() int16 { + return 0 +} + +func (d *DeleteRecordsRequest) requiredVersion() KafkaVersion { + return V0_11_0_0 +} + +type DeleteRecordsRequestTopic struct { + PartitionOffsets map[int32]int64 // partition => offset +} + +func (t *DeleteRecordsRequestTopic) encode(pe packetEncoder) error { + if err := pe.putArrayLength(len(t.PartitionOffsets)); err != nil { + return err + } + keys := make([]int32, 0, len(t.PartitionOffsets)) + for partition := range t.PartitionOffsets { + keys = append(keys, partition) + } + sort.Slice(keys, func(i, j int) bool { return keys[i] < keys[j] }) + for _, partition := range keys { + pe.putInt32(partition) + pe.putInt64(t.PartitionOffsets[partition]) + } + return nil +} + +func (t *DeleteRecordsRequestTopic) decode(pd packetDecoder, version int16) error { + n, err := pd.getArrayLength() + if err != nil { + return err + } + + if n > 0 { + t.PartitionOffsets = make(map[int32]int64, n) + for i := 0; i < n; i++ { + partition, err := pd.getInt32() + if err != nil { + return err + } + offset, err := pd.getInt64() + if err != nil { + return err + } + t.PartitionOffsets[partition] = offset + } + } + + return nil +} diff --git a/vendor/github.com/Shopify/sarama/delete_records_response.go b/vendor/github.com/Shopify/sarama/delete_records_response.go new file mode 100644 index 000000000000..733a58b6bc35 --- /dev/null +++ b/vendor/github.com/Shopify/sarama/delete_records_response.go @@ -0,0 +1,158 @@ +package sarama + +import ( + "sort" + "time" +) + +// response message format is: +// throttleMs(int32) [topic] +// where topic is: +// name(string) [partition] +// where partition is: +// id(int32) low_watermark(int64) error_code(int16) + +type DeleteRecordsResponse struct { + Version int16 + ThrottleTime time.Duration + Topics map[string]*DeleteRecordsResponseTopic +} + +func (d *DeleteRecordsResponse) encode(pe packetEncoder) error { + pe.putInt32(int32(d.ThrottleTime / time.Millisecond)) + + if err := pe.putArrayLength(len(d.Topics)); err != nil { + return err + } + keys := make([]string, 0, len(d.Topics)) + for topic := range d.Topics { + keys = append(keys, topic) + } + sort.Strings(keys) + for _, topic := range keys { + if err := pe.putString(topic); err != nil { + return err + } + if err := d.Topics[topic].encode(pe); err != nil { + return err + } + } + return nil +} + +func (d *DeleteRecordsResponse) decode(pd packetDecoder, version int16) error { + d.Version = version + + throttleTime, err := pd.getInt32() + if err != nil { + return err + } + d.ThrottleTime = time.Duration(throttleTime) * time.Millisecond + + n, err := pd.getArrayLength() + if err != nil { + return err + } + + if n > 0 { + d.Topics = make(map[string]*DeleteRecordsResponseTopic, n) + for i := 0; i < n; i++ { + topic, err := pd.getString() + if err != nil { + return err + } + details := new(DeleteRecordsResponseTopic) + if err = details.decode(pd, version); err != nil { + return err + } + d.Topics[topic] = details + } + } + + return nil +} + +func (d *DeleteRecordsResponse) key() int16 { + return 21 +} + +func (d *DeleteRecordsResponse) version() int16 { + return 0 +} + +func (d *DeleteRecordsResponse) requiredVersion() KafkaVersion { + return V0_11_0_0 +} + +type DeleteRecordsResponseTopic struct { + Partitions map[int32]*DeleteRecordsResponsePartition +} + +func (t *DeleteRecordsResponseTopic) encode(pe packetEncoder) error { + if err := pe.putArrayLength(len(t.Partitions)); err != nil { + return err + } + keys := make([]int32, 0, len(t.Partitions)) + for partition := range t.Partitions { + keys = append(keys, partition) + } + sort.Slice(keys, func(i, j int) bool { return keys[i] < keys[j] }) + for _, partition := range keys { + pe.putInt32(partition) + if err := t.Partitions[partition].encode(pe); err != nil { + return err + } + } + return nil +} + +func (t *DeleteRecordsResponseTopic) decode(pd packetDecoder, version int16) error { + n, err := pd.getArrayLength() + if err != nil { + return err + } + + if n > 0 { + t.Partitions = make(map[int32]*DeleteRecordsResponsePartition, n) + for i := 0; i < n; i++ { + partition, err := pd.getInt32() + if err != nil { + return err + } + details := new(DeleteRecordsResponsePartition) + if err = details.decode(pd, version); err != nil { + return err + } + t.Partitions[partition] = details + } + } + + return nil +} + +type DeleteRecordsResponsePartition struct { + LowWatermark int64 + Err KError +} + +func (t *DeleteRecordsResponsePartition) encode(pe packetEncoder) error { + pe.putInt64(t.LowWatermark) + pe.putInt16(int16(t.Err)) + return nil +} + +func (t *DeleteRecordsResponsePartition) decode(pd packetDecoder, version int16) error { + lowWatermark, err := pd.getInt64() + if err != nil { + return err + } + t.LowWatermark = lowWatermark + + kErr, err := pd.getInt16() + if err != nil { + return err + } + t.Err = KError(kErr) + + return nil +} diff --git a/vendor/github.com/Shopify/sarama/delete_topics_request.go b/vendor/github.com/Shopify/sarama/delete_topics_request.go index ed9089ea4789..911f67d31bab 100644 --- a/vendor/github.com/Shopify/sarama/delete_topics_request.go +++ b/vendor/github.com/Shopify/sarama/delete_topics_request.go @@ -3,6 +3,7 @@ package sarama import "time" type DeleteTopicsRequest struct { + Version int16 Topics []string Timeout time.Duration } @@ -25,6 +26,7 @@ func (d *DeleteTopicsRequest) decode(pd packetDecoder, version int16) (err error return err } d.Timeout = time.Duration(timeout) * time.Millisecond + d.Version = version return nil } @@ -33,9 +35,14 @@ func (d *DeleteTopicsRequest) key() int16 { } func (d *DeleteTopicsRequest) version() int16 { - return 0 + return d.Version } func (d *DeleteTopicsRequest) requiredVersion() KafkaVersion { - return V0_10_1_0 + switch d.Version { + case 1: + return V0_11_0_0 + default: + return V0_10_1_0 + } } diff --git a/vendor/github.com/Shopify/sarama/errors.go b/vendor/github.com/Shopify/sarama/errors.go index 54f431a4a91e..c578ef5fb437 100644 --- a/vendor/github.com/Shopify/sarama/errors.go +++ b/vendor/github.com/Shopify/sarama/errors.go @@ -41,6 +41,14 @@ var ErrMessageTooLarge = errors.New("kafka: message is larger than Consumer.Fetc // a RecordBatch. var ErrConsumerOffsetNotAdvanced = errors.New("kafka: consumer offset was not advanced after a RecordBatch") +// ErrControllerNotAvailable is returned when server didn't give correct controller id. May be kafka server's version +// is lower than 0.10.0.0. +var ErrControllerNotAvailable = errors.New("kafka: controller is not available") + +// ErrNoTopicsToUpdateMetadata is returned when Meta.Full is set to false but no specific topics were found to update +// the metadata. +var ErrNoTopicsToUpdateMetadata = errors.New("kafka: no specific topics to update metadata") + // PacketEncodingError is returned from a failure while encoding a Kafka packet. This can happen, for example, // if you try to encode a string over 2^15 characters in length, since Kafka's encoding rules do not permit that. type PacketEncodingError struct { diff --git a/vendor/github.com/Shopify/sarama/fetch_request.go b/vendor/github.com/Shopify/sarama/fetch_request.go index 8c8e3a5afc83..462ab8afbb8e 100644 --- a/vendor/github.com/Shopify/sarama/fetch_request.go +++ b/vendor/github.com/Shopify/sarama/fetch_request.go @@ -149,7 +149,7 @@ func (r *FetchRequest) requiredVersion() KafkaVersion { case 4: return V0_11_0_0 default: - return minVersion + return MinVersion } } diff --git a/vendor/github.com/Shopify/sarama/fetch_response.go b/vendor/github.com/Shopify/sarama/fetch_response.go index 0e81ad89f434..ae91bb9eb097 100644 --- a/vendor/github.com/Shopify/sarama/fetch_response.go +++ b/vendor/github.com/Shopify/sarama/fetch_response.go @@ -280,7 +280,7 @@ func (r *FetchResponse) requiredVersion() KafkaVersion { case 4: return V0_11_0_0 default: - return minVersion + return MinVersion } } @@ -353,7 +353,7 @@ func (r *FetchResponse) AddMessage(topic string, partition int32, key, value Enc records := newLegacyRecords(&MessageSet{}) frb.RecordsSet = []*Records{&records} } - set := frb.RecordsSet[0].msgSet + set := frb.RecordsSet[0].MsgSet set.Messages = append(set.Messages, msgBlock) } @@ -365,7 +365,7 @@ func (r *FetchResponse) AddRecord(topic string, partition int32, key, value Enco records := newDefaultRecords(&RecordBatch{Version: 2}) frb.RecordsSet = []*Records{&records} } - batch := frb.RecordsSet[0].recordBatch + batch := frb.RecordsSet[0].RecordBatch batch.addRecord(rec) } @@ -375,7 +375,7 @@ func (r *FetchResponse) SetLastOffsetDelta(topic string, partition int32, offset records := newDefaultRecords(&RecordBatch{Version: 2}) frb.RecordsSet = []*Records{&records} } - batch := frb.RecordsSet[0].recordBatch + batch := frb.RecordsSet[0].RecordBatch batch.LastOffsetDelta = offset } diff --git a/vendor/github.com/Shopify/sarama/find_coordinator_request.go b/vendor/github.com/Shopify/sarama/find_coordinator_request.go new file mode 100644 index 000000000000..0ab5cb5ff575 --- /dev/null +++ b/vendor/github.com/Shopify/sarama/find_coordinator_request.go @@ -0,0 +1,61 @@ +package sarama + +type CoordinatorType int8 + +const ( + CoordinatorGroup CoordinatorType = 0 + CoordinatorTransaction CoordinatorType = 1 +) + +type FindCoordinatorRequest struct { + Version int16 + CoordinatorKey string + CoordinatorType CoordinatorType +} + +func (f *FindCoordinatorRequest) encode(pe packetEncoder) error { + if err := pe.putString(f.CoordinatorKey); err != nil { + return err + } + + if f.Version >= 1 { + pe.putInt8(int8(f.CoordinatorType)) + } + + return nil +} + +func (f *FindCoordinatorRequest) decode(pd packetDecoder, version int16) (err error) { + if f.CoordinatorKey, err = pd.getString(); err != nil { + return err + } + + if version >= 1 { + f.Version = version + coordinatorType, err := pd.getInt8() + if err != nil { + return err + } + + f.CoordinatorType = CoordinatorType(coordinatorType) + } + + return nil +} + +func (f *FindCoordinatorRequest) key() int16 { + return 10 +} + +func (f *FindCoordinatorRequest) version() int16 { + return f.Version +} + +func (f *FindCoordinatorRequest) requiredVersion() KafkaVersion { + switch f.Version { + case 1: + return V0_11_0_0 + default: + return V0_8_2_0 + } +} diff --git a/vendor/github.com/Shopify/sarama/find_coordinator_response.go b/vendor/github.com/Shopify/sarama/find_coordinator_response.go new file mode 100644 index 000000000000..9c900e8b7742 --- /dev/null +++ b/vendor/github.com/Shopify/sarama/find_coordinator_response.go @@ -0,0 +1,92 @@ +package sarama + +import ( + "time" +) + +var NoNode = &Broker{id: -1, addr: ":-1"} + +type FindCoordinatorResponse struct { + Version int16 + ThrottleTime time.Duration + Err KError + ErrMsg *string + Coordinator *Broker +} + +func (f *FindCoordinatorResponse) decode(pd packetDecoder, version int16) (err error) { + if version >= 1 { + f.Version = version + + throttleTime, err := pd.getInt32() + if err != nil { + return err + } + f.ThrottleTime = time.Duration(throttleTime) * time.Millisecond + } + + tmp, err := pd.getInt16() + if err != nil { + return err + } + f.Err = KError(tmp) + + if version >= 1 { + if f.ErrMsg, err = pd.getNullableString(); err != nil { + return err + } + } + + coordinator := new(Broker) + // The version is hardcoded to 0, as version 1 of the Broker-decode + // contains the rack-field which is not present in the FindCoordinatorResponse. + if err := coordinator.decode(pd, 0); err != nil { + return err + } + if coordinator.addr == ":0" { + return nil + } + f.Coordinator = coordinator + + return nil +} + +func (f *FindCoordinatorResponse) encode(pe packetEncoder) error { + if f.Version >= 1 { + pe.putInt32(int32(f.ThrottleTime / time.Millisecond)) + } + + pe.putInt16(int16(f.Err)) + + if f.Version >= 1 { + if err := pe.putNullableString(f.ErrMsg); err != nil { + return err + } + } + + coordinator := f.Coordinator + if coordinator == nil { + coordinator = NoNode + } + if err := coordinator.encode(pe, 0); err != nil { + return err + } + return nil +} + +func (f *FindCoordinatorResponse) key() int16 { + return 10 +} + +func (f *FindCoordinatorResponse) version() int16 { + return f.Version +} + +func (f *FindCoordinatorResponse) requiredVersion() KafkaVersion { + switch f.Version { + case 1: + return V0_11_0_0 + default: + return V0_8_2_0 + } +} diff --git a/vendor/github.com/Shopify/sarama/join_group_request.go b/vendor/github.com/Shopify/sarama/join_group_request.go index 3a7ba17122d3..97e9299ea1a3 100644 --- a/vendor/github.com/Shopify/sarama/join_group_request.go +++ b/vendor/github.com/Shopify/sarama/join_group_request.go @@ -25,8 +25,10 @@ func (p *GroupProtocol) encode(pe packetEncoder) (err error) { } type JoinGroupRequest struct { + Version int16 GroupId string SessionTimeout int32 + RebalanceTimeout int32 MemberId string ProtocolType string GroupProtocols map[string][]byte // deprecated; use OrderedGroupProtocols @@ -38,6 +40,9 @@ func (r *JoinGroupRequest) encode(pe packetEncoder) error { return err } pe.putInt32(r.SessionTimeout) + if r.Version >= 1 { + pe.putInt32(r.RebalanceTimeout) + } if err := pe.putString(r.MemberId); err != nil { return err } @@ -76,6 +81,8 @@ func (r *JoinGroupRequest) encode(pe packetEncoder) error { } func (r *JoinGroupRequest) decode(pd packetDecoder, version int16) (err error) { + r.Version = version + if r.GroupId, err = pd.getString(); err != nil { return } @@ -84,6 +91,12 @@ func (r *JoinGroupRequest) decode(pd packetDecoder, version int16) (err error) { return } + if version >= 1 { + if r.RebalanceTimeout, err = pd.getInt32(); err != nil { + return err + } + } + if r.MemberId, err = pd.getString(); err != nil { return } @@ -118,11 +131,18 @@ func (r *JoinGroupRequest) key() int16 { } func (r *JoinGroupRequest) version() int16 { - return 0 + return r.Version } func (r *JoinGroupRequest) requiredVersion() KafkaVersion { - return V0_9_0_0 + switch r.Version { + case 2: + return V0_11_0_0 + case 1: + return V0_10_1_0 + default: + return V0_9_0_0 + } } func (r *JoinGroupRequest) AddGroupProtocol(name string, metadata []byte) { diff --git a/vendor/github.com/Shopify/sarama/join_group_response.go b/vendor/github.com/Shopify/sarama/join_group_response.go index 6d35fe36494e..5752acc8aeb7 100644 --- a/vendor/github.com/Shopify/sarama/join_group_response.go +++ b/vendor/github.com/Shopify/sarama/join_group_response.go @@ -1,6 +1,8 @@ package sarama type JoinGroupResponse struct { + Version int16 + ThrottleTime int32 Err KError GenerationId int32 GroupProtocol string @@ -22,6 +24,9 @@ func (r *JoinGroupResponse) GetMembers() (map[string]ConsumerGroupMemberMetadata } func (r *JoinGroupResponse) encode(pe packetEncoder) error { + if r.Version >= 2 { + pe.putInt32(r.ThrottleTime) + } pe.putInt16(int16(r.Err)) pe.putInt32(r.GenerationId) @@ -53,6 +58,14 @@ func (r *JoinGroupResponse) encode(pe packetEncoder) error { } func (r *JoinGroupResponse) decode(pd packetDecoder, version int16) (err error) { + r.Version = version + + if version >= 2 { + if r.ThrottleTime, err = pd.getInt32(); err != nil { + return + } + } + kerr, err := pd.getInt16() if err != nil { return err @@ -107,9 +120,16 @@ func (r *JoinGroupResponse) key() int16 { } func (r *JoinGroupResponse) version() int16 { - return 0 + return r.Version } func (r *JoinGroupResponse) requiredVersion() KafkaVersion { - return V0_9_0_0 + switch r.Version { + case 2: + return V0_11_0_0 + case 1: + return V0_10_1_0 + default: + return V0_9_0_0 + } } diff --git a/vendor/github.com/Shopify/sarama/message.go b/vendor/github.com/Shopify/sarama/message.go index bd5650bbc07f..fecdbfdef758 100644 --- a/vendor/github.com/Shopify/sarama/message.go +++ b/vendor/github.com/Shopify/sarama/message.go @@ -24,13 +24,28 @@ const ( CompressionLZ4 CompressionCodec = 3 ) +func (cc CompressionCodec) String() string { + return []string{ + "none", + "gzip", + "snappy", + "lz4", + }[int(cc)] +} + +// CompressionLevelDefault is the constant to use in CompressionLevel +// to have the default compression level for any codec. The value is picked +// that we don't use any existing compression levels. +const CompressionLevelDefault = -1000 + type Message struct { - Codec CompressionCodec // codec used to compress the message contents - Key []byte // the message key, may be nil - Value []byte // the message contents - Set *MessageSet // the message set a message might wrap - Version int8 // v1 requires Kafka 0.10 - Timestamp time.Time // the timestamp of the message (version 1+ only) + Codec CompressionCodec // codec used to compress the message contents + CompressionLevel int // compression level + Key []byte // the message key, may be nil + Value []byte // the message contents + Set *MessageSet // the message set a message might wrap + Version int8 // v1 requires Kafka 0.10 + Timestamp time.Time // the timestamp of the message (version 1+ only) compressedCache []byte compressedSize int // used for computing the compression ratio metrics @@ -66,7 +81,15 @@ func (m *Message) encode(pe packetEncoder) error { payload = m.Value case CompressionGZIP: var buf bytes.Buffer - writer := gzip.NewWriter(&buf) + var writer *gzip.Writer + if m.CompressionLevel != CompressionLevelDefault { + writer, err = gzip.NewWriterLevel(&buf, m.CompressionLevel) + if err != nil { + return err + } + } else { + writer = gzip.NewWriter(&buf) + } if _, err = writer.Write(m.Value); err != nil { return err } diff --git a/vendor/github.com/Shopify/sarama/metadata_request.go b/vendor/github.com/Shopify/sarama/metadata_request.go index 9a26b55fd032..48adfa28cb93 100644 --- a/vendor/github.com/Shopify/sarama/metadata_request.go +++ b/vendor/github.com/Shopify/sarama/metadata_request.go @@ -1,40 +1,65 @@ package sarama type MetadataRequest struct { - Topics []string + Version int16 + Topics []string + AllowAutoTopicCreation bool } func (r *MetadataRequest) encode(pe packetEncoder) error { - err := pe.putArrayLength(len(r.Topics)) - if err != nil { - return err + if r.Version < 0 || r.Version > 5 { + return PacketEncodingError{"invalid or unsupported MetadataRequest version field"} } - - for i := range r.Topics { - err = pe.putString(r.Topics[i]) + if r.Version == 0 || r.Topics != nil || len(r.Topics) > 0 { + err := pe.putArrayLength(len(r.Topics)) if err != nil { return err } + + for i := range r.Topics { + err = pe.putString(r.Topics[i]) + if err != nil { + return err + } + } + } else { + pe.putInt32(-1) + } + if r.Version > 3 { + pe.putBool(r.AllowAutoTopicCreation) } return nil } func (r *MetadataRequest) decode(pd packetDecoder, version int16) error { - topicCount, err := pd.getArrayLength() + r.Version = version + size, err := pd.getInt32() if err != nil { return err } - if topicCount == 0 { + if size < 0 { return nil - } + } else { + topicCount := size + if topicCount == 0 { + return nil + } - r.Topics = make([]string, topicCount) - for i := range r.Topics { - topic, err := pd.getString() + r.Topics = make([]string, topicCount) + for i := range r.Topics { + topic, err := pd.getString() + if err != nil { + return err + } + r.Topics[i] = topic + } + } + if r.Version > 3 { + autoCreation, err := pd.getBool() if err != nil { return err } - r.Topics[i] = topic + r.AllowAutoTopicCreation = autoCreation } return nil } @@ -44,9 +69,20 @@ func (r *MetadataRequest) key() int16 { } func (r *MetadataRequest) version() int16 { - return 0 + return r.Version } func (r *MetadataRequest) requiredVersion() KafkaVersion { - return minVersion + switch r.Version { + case 1: + return V0_10_0_0 + case 2: + return V0_10_1_0 + case 3, 4: + return V0_11_0_0 + case 5: + return V1_0_0_0 + default: + return MinVersion + } } diff --git a/vendor/github.com/Shopify/sarama/metadata_response.go b/vendor/github.com/Shopify/sarama/metadata_response.go index f9d6a4271edc..bf8a67bbc524 100644 --- a/vendor/github.com/Shopify/sarama/metadata_response.go +++ b/vendor/github.com/Shopify/sarama/metadata_response.go @@ -1,14 +1,15 @@ package sarama type PartitionMetadata struct { - Err KError - ID int32 - Leader int32 - Replicas []int32 - Isr []int32 + Err KError + ID int32 + Leader int32 + Replicas []int32 + Isr []int32 + OfflineReplicas []int32 } -func (pm *PartitionMetadata) decode(pd packetDecoder) (err error) { +func (pm *PartitionMetadata) decode(pd packetDecoder, version int16) (err error) { tmp, err := pd.getInt16() if err != nil { return err @@ -35,10 +36,17 @@ func (pm *PartitionMetadata) decode(pd packetDecoder) (err error) { return err } + if version >= 5 { + pm.OfflineReplicas, err = pd.getInt32Array() + if err != nil { + return err + } + } + return nil } -func (pm *PartitionMetadata) encode(pe packetEncoder) (err error) { +func (pm *PartitionMetadata) encode(pe packetEncoder, version int16) (err error) { pe.putInt16(int16(pm.Err)) pe.putInt32(pm.ID) pe.putInt32(pm.Leader) @@ -53,16 +61,24 @@ func (pm *PartitionMetadata) encode(pe packetEncoder) (err error) { return err } + if version >= 5 { + err = pe.putInt32Array(pm.OfflineReplicas) + if err != nil { + return err + } + } + return nil } type TopicMetadata struct { Err KError Name string + IsInternal bool // Only valid for Version >= 1 Partitions []*PartitionMetadata } -func (tm *TopicMetadata) decode(pd packetDecoder) (err error) { +func (tm *TopicMetadata) decode(pd packetDecoder, version int16) (err error) { tmp, err := pd.getInt16() if err != nil { return err @@ -74,6 +90,13 @@ func (tm *TopicMetadata) decode(pd packetDecoder) (err error) { return err } + if version >= 1 { + tm.IsInternal, err = pd.getBool() + if err != nil { + return err + } + } + n, err := pd.getArrayLength() if err != nil { return err @@ -81,7 +104,7 @@ func (tm *TopicMetadata) decode(pd packetDecoder) (err error) { tm.Partitions = make([]*PartitionMetadata, n) for i := 0; i < n; i++ { tm.Partitions[i] = new(PartitionMetadata) - err = tm.Partitions[i].decode(pd) + err = tm.Partitions[i].decode(pd, version) if err != nil { return err } @@ -90,7 +113,7 @@ func (tm *TopicMetadata) decode(pd packetDecoder) (err error) { return nil } -func (tm *TopicMetadata) encode(pe packetEncoder) (err error) { +func (tm *TopicMetadata) encode(pe packetEncoder, version int16) (err error) { pe.putInt16(int16(tm.Err)) err = pe.putString(tm.Name) @@ -98,13 +121,17 @@ func (tm *TopicMetadata) encode(pe packetEncoder) (err error) { return err } + if version >= 1 { + pe.putBool(tm.IsInternal) + } + err = pe.putArrayLength(len(tm.Partitions)) if err != nil { return err } for _, pm := range tm.Partitions { - err = pm.encode(pe) + err = pm.encode(pe, version) if err != nil { return err } @@ -114,11 +141,24 @@ func (tm *TopicMetadata) encode(pe packetEncoder) (err error) { } type MetadataResponse struct { - Brokers []*Broker - Topics []*TopicMetadata + Version int16 + ThrottleTimeMs int32 + Brokers []*Broker + ClusterID *string + ControllerID int32 + Topics []*TopicMetadata } func (r *MetadataResponse) decode(pd packetDecoder, version int16) (err error) { + r.Version = version + + if version >= 3 { + r.ThrottleTimeMs, err = pd.getInt32() + if err != nil { + return err + } + } + n, err := pd.getArrayLength() if err != nil { return err @@ -127,12 +167,28 @@ func (r *MetadataResponse) decode(pd packetDecoder, version int16) (err error) { r.Brokers = make([]*Broker, n) for i := 0; i < n; i++ { r.Brokers[i] = new(Broker) - err = r.Brokers[i].decode(pd) + err = r.Brokers[i].decode(pd, version) + if err != nil { + return err + } + } + + if version >= 2 { + r.ClusterID, err = pd.getNullableString() if err != nil { return err } } + if version >= 1 { + r.ControllerID, err = pd.getInt32() + if err != nil { + return err + } + } else { + r.ControllerID = -1 + } + n, err = pd.getArrayLength() if err != nil { return err @@ -141,7 +197,7 @@ func (r *MetadataResponse) decode(pd packetDecoder, version int16) (err error) { r.Topics = make([]*TopicMetadata, n) for i := 0; i < n; i++ { r.Topics[i] = new(TopicMetadata) - err = r.Topics[i].decode(pd) + err = r.Topics[i].decode(pd, version) if err != nil { return err } @@ -156,18 +212,22 @@ func (r *MetadataResponse) encode(pe packetEncoder) error { return err } for _, broker := range r.Brokers { - err = broker.encode(pe) + err = broker.encode(pe, r.Version) if err != nil { return err } } + if r.Version >= 1 { + pe.putInt32(r.ControllerID) + } + err = pe.putArrayLength(len(r.Topics)) if err != nil { return err } for _, tm := range r.Topics { - err = tm.encode(pe) + err = tm.encode(pe, r.Version) if err != nil { return err } @@ -181,11 +241,22 @@ func (r *MetadataResponse) key() int16 { } func (r *MetadataResponse) version() int16 { - return 0 + return r.Version } func (r *MetadataResponse) requiredVersion() KafkaVersion { - return minVersion + switch r.Version { + case 1: + return V0_10_0_0 + case 2: + return V0_10_1_0 + case 3, 4: + return V0_11_0_0 + case 5: + return V1_0_0_0 + default: + return MinVersion + } } // testing API diff --git a/vendor/github.com/Shopify/sarama/mockresponses.go b/vendor/github.com/Shopify/sarama/mockresponses.go index f79a9d5e9b42..5541d32ec69c 100644 --- a/vendor/github.com/Shopify/sarama/mockresponses.go +++ b/vendor/github.com/Shopify/sarama/mockresponses.go @@ -68,9 +68,10 @@ func (mc *MockSequence) For(reqBody versionedDecoder) (res encoder) { // MockMetadataResponse is a `MetadataResponse` builder. type MockMetadataResponse struct { - leaders map[string]map[int32]int32 - brokers map[string]int32 - t TestReporter + controllerID int32 + leaders map[string]map[int32]int32 + brokers map[string]int32 + t TestReporter } func NewMockMetadataResponse(t TestReporter) *MockMetadataResponse { @@ -96,9 +97,17 @@ func (mmr *MockMetadataResponse) SetBroker(addr string, brokerID int32) *MockMet return mmr } +func (mmr *MockMetadataResponse) SetController(brokerID int32) *MockMetadataResponse { + mmr.controllerID = brokerID + return mmr +} + func (mmr *MockMetadataResponse) For(reqBody versionedDecoder) encoder { metadataRequest := reqBody.(*MetadataRequest) - metadataResponse := &MetadataResponse{} + metadataResponse := &MetadataResponse{ + Version: metadataRequest.version(), + ControllerID: mmr.controllerID, + } for addr, brokerID := range mmr.brokers { metadataResponse.AddBroker(addr, brokerID) } @@ -326,6 +335,60 @@ func (mr *MockConsumerMetadataResponse) For(reqBody versionedDecoder) encoder { return res } +// MockFindCoordinatorResponse is a `FindCoordinatorResponse` builder. +type MockFindCoordinatorResponse struct { + groupCoordinators map[string]interface{} + transCoordinators map[string]interface{} + t TestReporter +} + +func NewMockFindCoordinatorResponse(t TestReporter) *MockFindCoordinatorResponse { + return &MockFindCoordinatorResponse{ + groupCoordinators: make(map[string]interface{}), + transCoordinators: make(map[string]interface{}), + t: t, + } +} + +func (mr *MockFindCoordinatorResponse) SetCoordinator(coordinatorType CoordinatorType, group string, broker *MockBroker) *MockFindCoordinatorResponse { + switch coordinatorType { + case CoordinatorGroup: + mr.groupCoordinators[group] = broker + case CoordinatorTransaction: + mr.transCoordinators[group] = broker + } + return mr +} + +func (mr *MockFindCoordinatorResponse) SetError(coordinatorType CoordinatorType, group string, kerror KError) *MockFindCoordinatorResponse { + switch coordinatorType { + case CoordinatorGroup: + mr.groupCoordinators[group] = kerror + case CoordinatorTransaction: + mr.transCoordinators[group] = kerror + } + return mr +} + +func (mr *MockFindCoordinatorResponse) For(reqBody versionedDecoder) encoder { + req := reqBody.(*FindCoordinatorRequest) + res := &FindCoordinatorResponse{} + var v interface{} + switch req.CoordinatorType { + case CoordinatorGroup: + v = mr.groupCoordinators[req.CoordinatorKey] + case CoordinatorTransaction: + v = mr.transCoordinators[req.CoordinatorKey] + } + switch v := v.(type) { + case *MockBroker: + res.Coordinator = &Broker{id: v.BrokerID(), addr: v.Addr()} + case KError: + res.Err = v + } + return res +} + // MockOffsetCommitResponse is a `OffsetCommitResponse` builder. type MockOffsetCommitResponse struct { errors map[string]map[string]map[int32]KError diff --git a/vendor/github.com/Shopify/sarama/offset_commit_request.go b/vendor/github.com/Shopify/sarama/offset_commit_request.go index b21ea634b024..37e99fbf5b86 100644 --- a/vendor/github.com/Shopify/sarama/offset_commit_request.go +++ b/vendor/github.com/Shopify/sarama/offset_commit_request.go @@ -1,5 +1,7 @@ package sarama +import "errors" + // ReceiveTime is a special value for the timestamp field of Offset Commit Requests which // tells the broker to set the timestamp to the time at which the request was received. // The timestamp is only used if message version 1 is used, which requires kafka 0.8.2. @@ -173,7 +175,7 @@ func (r *OffsetCommitRequest) requiredVersion() KafkaVersion { case 2: return V0_9_0_0 default: - return minVersion + return MinVersion } } @@ -188,3 +190,15 @@ func (r *OffsetCommitRequest) AddBlock(topic string, partitionID int32, offset i r.blocks[topic][partitionID] = &offsetCommitRequestBlock{offset, timestamp, metadata} } + +func (r *OffsetCommitRequest) Offset(topic string, partitionID int32) (int64, string, error) { + partitions := r.blocks[topic] + if partitions == nil { + return 0, "", errors.New("No such offset") + } + block := partitions[partitionID] + if block == nil { + return 0, "", errors.New("No such offset") + } + return block.offset, block.metadata, nil +} diff --git a/vendor/github.com/Shopify/sarama/offset_commit_response.go b/vendor/github.com/Shopify/sarama/offset_commit_response.go index 7f277e7753a1..a4b18acdff29 100644 --- a/vendor/github.com/Shopify/sarama/offset_commit_response.go +++ b/vendor/github.com/Shopify/sarama/offset_commit_response.go @@ -81,5 +81,5 @@ func (r *OffsetCommitResponse) version() int16 { } func (r *OffsetCommitResponse) requiredVersion() KafkaVersion { - return minVersion + return MinVersion } diff --git a/vendor/github.com/Shopify/sarama/offset_fetch_request.go b/vendor/github.com/Shopify/sarama/offset_fetch_request.go index b19fe79ba7aa..5a05014b481f 100644 --- a/vendor/github.com/Shopify/sarama/offset_fetch_request.go +++ b/vendor/github.com/Shopify/sarama/offset_fetch_request.go @@ -68,7 +68,7 @@ func (r *OffsetFetchRequest) requiredVersion() KafkaVersion { case 1: return V0_8_2_0 default: - return minVersion + return MinVersion } } diff --git a/vendor/github.com/Shopify/sarama/offset_fetch_response.go b/vendor/github.com/Shopify/sarama/offset_fetch_response.go index 323220eac976..11e4b1f3fdfe 100644 --- a/vendor/github.com/Shopify/sarama/offset_fetch_response.go +++ b/vendor/github.com/Shopify/sarama/offset_fetch_response.go @@ -115,7 +115,7 @@ func (r *OffsetFetchResponse) version() int16 { } func (r *OffsetFetchResponse) requiredVersion() KafkaVersion { - return minVersion + return MinVersion } func (r *OffsetFetchResponse) GetBlock(topic string, partition int32) *OffsetFetchResponseBlock { diff --git a/vendor/github.com/Shopify/sarama/offset_request.go b/vendor/github.com/Shopify/sarama/offset_request.go index a14f71828dfb..687fef284a2a 100644 --- a/vendor/github.com/Shopify/sarama/offset_request.go +++ b/vendor/github.com/Shopify/sarama/offset_request.go @@ -117,7 +117,7 @@ func (r *OffsetRequest) requiredVersion() KafkaVersion { case 1: return V0_10_1_0 default: - return minVersion + return MinVersion } } diff --git a/vendor/github.com/Shopify/sarama/offset_response.go b/vendor/github.com/Shopify/sarama/offset_response.go index 9a9cfe96f3ba..8b2193f9a0bf 100644 --- a/vendor/github.com/Shopify/sarama/offset_response.go +++ b/vendor/github.com/Shopify/sarama/offset_response.go @@ -155,7 +155,7 @@ func (r *OffsetResponse) requiredVersion() KafkaVersion { case 1: return V0_10_1_0 default: - return minVersion + return MinVersion } } diff --git a/vendor/github.com/Shopify/sarama/produce_request.go b/vendor/github.com/Shopify/sarama/produce_request.go index 0ec4d8d53f97..0c755d02b646 100644 --- a/vendor/github.com/Shopify/sarama/produce_request.go +++ b/vendor/github.com/Shopify/sarama/produce_request.go @@ -113,9 +113,9 @@ func (r *ProduceRequest) encode(pe packetEncoder) error { } if metricRegistry != nil { if r.Version >= 3 { - topicRecordCount += updateBatchMetrics(records.recordBatch, compressionRatioMetric, topicCompressionRatioMetric) + topicRecordCount += updateBatchMetrics(records.RecordBatch, compressionRatioMetric, topicCompressionRatioMetric) } else { - topicRecordCount += updateMsgSetMetrics(records.msgSet, compressionRatioMetric, topicCompressionRatioMetric) + topicRecordCount += updateMsgSetMetrics(records.MsgSet, compressionRatioMetric, topicCompressionRatioMetric) } batchSize := int64(pe.offset() - startOffset) batchSizeMetric.Update(batchSize) @@ -215,7 +215,7 @@ func (r *ProduceRequest) requiredVersion() KafkaVersion { case 3: return V0_11_0_0 default: - return minVersion + return MinVersion } } @@ -231,7 +231,7 @@ func (r *ProduceRequest) ensureRecords(topic string, partition int32) { func (r *ProduceRequest) AddMessage(topic string, partition int32, msg *Message) { r.ensureRecords(topic, partition) - set := r.records[topic][partition].msgSet + set := r.records[topic][partition].MsgSet if set == nil { set = new(MessageSet) diff --git a/vendor/github.com/Shopify/sarama/produce_response.go b/vendor/github.com/Shopify/sarama/produce_response.go index 043c40f87723..667e34c661b5 100644 --- a/vendor/github.com/Shopify/sarama/produce_response.go +++ b/vendor/github.com/Shopify/sarama/produce_response.go @@ -152,7 +152,7 @@ func (r *ProduceResponse) requiredVersion() KafkaVersion { case 3: return V0_11_0_0 default: - return minVersion + return MinVersion } } diff --git a/vendor/github.com/Shopify/sarama/produce_set.go b/vendor/github.com/Shopify/sarama/produce_set.go index 3cbaeb5f90ea..13be2b3c92b1 100644 --- a/vendor/github.com/Shopify/sarama/produce_set.go +++ b/vendor/github.com/Shopify/sarama/produce_set.go @@ -59,10 +59,11 @@ func (ps *produceSet) add(msg *ProducerMessage) error { if set == nil { if ps.parent.conf.Version.IsAtLeast(V0_11_0_0) { batch := &RecordBatch{ - FirstTimestamp: timestamp, - Version: 2, - ProducerID: -1, /* No producer id */ - Codec: ps.parent.conf.Producer.Compression, + FirstTimestamp: timestamp, + Version: 2, + ProducerID: -1, /* No producer id */ + Codec: ps.parent.conf.Producer.Compression, + CompressionLevel: ps.parent.conf.Producer.CompressionLevel, } set = &partitionSet{recordsToSend: newDefaultRecords(batch)} size = recordBatchOverhead @@ -79,7 +80,7 @@ func (ps *produceSet) add(msg *ProducerMessage) error { rec := &Record{ Key: key, Value: val, - TimestampDelta: timestamp.Sub(set.recordsToSend.recordBatch.FirstTimestamp), + TimestampDelta: timestamp.Sub(set.recordsToSend.RecordBatch.FirstTimestamp), } size += len(key) + len(val) if len(msg.Headers) > 0 { @@ -89,14 +90,14 @@ func (ps *produceSet) add(msg *ProducerMessage) error { size += len(rec.Headers[i].Key) + len(rec.Headers[i].Value) + 2*binary.MaxVarintLen32 } } - set.recordsToSend.recordBatch.addRecord(rec) + set.recordsToSend.RecordBatch.addRecord(rec) } else { msgToSend := &Message{Codec: CompressionNone, Key: key, Value: val} if ps.parent.conf.Version.IsAtLeast(V0_10_0_0) { msgToSend.Timestamp = timestamp msgToSend.Version = 1 } - set.recordsToSend.msgSet.addMessage(msgToSend) + set.recordsToSend.MsgSet.addMessage(msgToSend) size = producerMessageOverhead + len(key) + len(val) } @@ -122,7 +123,14 @@ func (ps *produceSet) buildRequest() *ProduceRequest { for topic, partitionSet := range ps.msgs { for partition, set := range partitionSet { if req.Version >= 3 { - rb := set.recordsToSend.recordBatch + // If the API version we're hitting is 3 or greater, we need to calculate + // offsets for each record in the batch relative to FirstOffset. + // Additionally, we must set LastOffsetDelta to the value of the last offset + // in the batch. Since the OffsetDelta of the first record is 0, we know that the + // final record of any batch will have an offset of (# of records in batch) - 1. + // (See https://cwiki.apache.org/confluence/display/KAFKA/A+Guide+To+The+Kafka+Protocol#AGuideToTheKafkaProtocol-Messagesets + // under the RecordBatch section for details.) + rb := set.recordsToSend.RecordBatch if len(rb.Records) > 0 { rb.LastOffsetDelta = int32(len(rb.Records) - 1) for i, record := range rb.Records { @@ -134,7 +142,7 @@ func (ps *produceSet) buildRequest() *ProduceRequest { continue } if ps.parent.conf.Producer.Compression == CompressionNone { - req.AddSet(topic, partition, set.recordsToSend.msgSet) + req.AddSet(topic, partition, set.recordsToSend.MsgSet) } else { // When compression is enabled, the entire set for each partition is compressed // and sent as the payload of a single fake "message" with the appropriate codec @@ -147,24 +155,25 @@ func (ps *produceSet) buildRequest() *ProduceRequest { // recompressing the message set. // (See https://cwiki.apache.org/confluence/display/KAFKA/KIP-31+-+Move+to+relative+offsets+in+compressed+message+sets // for details on relative offsets.) - for i, msg := range set.recordsToSend.msgSet.Messages { + for i, msg := range set.recordsToSend.MsgSet.Messages { msg.Offset = int64(i) } } - payload, err := encode(set.recordsToSend.msgSet, ps.parent.conf.MetricRegistry) + payload, err := encode(set.recordsToSend.MsgSet, ps.parent.conf.MetricRegistry) if err != nil { Logger.Println(err) // if this happens, it's basically our fault. panic(err) } compMsg := &Message{ - Codec: ps.parent.conf.Producer.Compression, - Key: nil, - Value: payload, - Set: set.recordsToSend.msgSet, // Provide the underlying message set for accurate metrics + Codec: ps.parent.conf.Producer.Compression, + CompressionLevel: ps.parent.conf.Producer.CompressionLevel, + Key: nil, + Value: payload, + Set: set.recordsToSend.MsgSet, // Provide the underlying message set for accurate metrics } if ps.parent.conf.Version.IsAtLeast(V0_10_0_0) { compMsg.Version = 1 - compMsg.Timestamp = set.recordsToSend.msgSet.Messages[0].Msg.Timestamp + compMsg.Timestamp = set.recordsToSend.MsgSet.Messages[0].Msg.Timestamp } req.AddMessage(topic, partition, compMsg) } diff --git a/vendor/github.com/Shopify/sarama/record_batch.go b/vendor/github.com/Shopify/sarama/record_batch.go index 321de485b0db..845318aa3417 100644 --- a/vendor/github.com/Shopify/sarama/record_batch.go +++ b/vendor/github.com/Shopify/sarama/record_batch.go @@ -40,6 +40,7 @@ type RecordBatch struct { PartitionLeaderEpoch int32 Version int8 Codec CompressionCodec + CompressionLevel int Control bool LastOffsetDelta int32 FirstTimestamp time.Time @@ -219,7 +220,15 @@ func (b *RecordBatch) encodeRecords(pe packetEncoder) error { b.compressedRecords = raw case CompressionGZIP: var buf bytes.Buffer - writer := gzip.NewWriter(&buf) + var writer *gzip.Writer + if b.CompressionLevel != CompressionLevelDefault { + writer, err = gzip.NewWriterLevel(&buf, b.CompressionLevel) + if err != nil { + return err + } + } else { + writer = gzip.NewWriter(&buf) + } if _, err := writer.Write(raw); err != nil { return err } diff --git a/vendor/github.com/Shopify/sarama/records.go b/vendor/github.com/Shopify/sarama/records.go index 258dcbac880a..301055bb070c 100644 --- a/vendor/github.com/Shopify/sarama/records.go +++ b/vendor/github.com/Shopify/sarama/records.go @@ -14,30 +14,30 @@ const ( // Records implements a union type containing either a RecordBatch or a legacy MessageSet. type Records struct { recordsType int - msgSet *MessageSet - recordBatch *RecordBatch + MsgSet *MessageSet + RecordBatch *RecordBatch } func newLegacyRecords(msgSet *MessageSet) Records { - return Records{recordsType: legacyRecords, msgSet: msgSet} + return Records{recordsType: legacyRecords, MsgSet: msgSet} } func newDefaultRecords(batch *RecordBatch) Records { - return Records{recordsType: defaultRecords, recordBatch: batch} + return Records{recordsType: defaultRecords, RecordBatch: batch} } -// setTypeFromFields sets type of Records depending on which of msgSet or recordBatch is not nil. +// setTypeFromFields sets type of Records depending on which of MsgSet or RecordBatch is not nil. // The first return value indicates whether both fields are nil (and the type is not set). // If both fields are not nil, it returns an error. func (r *Records) setTypeFromFields() (bool, error) { - if r.msgSet == nil && r.recordBatch == nil { + if r.MsgSet == nil && r.RecordBatch == nil { return true, nil } - if r.msgSet != nil && r.recordBatch != nil { - return false, fmt.Errorf("both msgSet and recordBatch are set, but record type is unknown") + if r.MsgSet != nil && r.RecordBatch != nil { + return false, fmt.Errorf("both MsgSet and RecordBatch are set, but record type is unknown") } r.recordsType = defaultRecords - if r.msgSet != nil { + if r.MsgSet != nil { r.recordsType = legacyRecords } return false, nil @@ -52,15 +52,15 @@ func (r *Records) encode(pe packetEncoder) error { switch r.recordsType { case legacyRecords: - if r.msgSet == nil { + if r.MsgSet == nil { return nil } - return r.msgSet.encode(pe) + return r.MsgSet.encode(pe) case defaultRecords: - if r.recordBatch == nil { + if r.RecordBatch == nil { return nil } - return r.recordBatch.encode(pe) + return r.RecordBatch.encode(pe) } return fmt.Errorf("unknown records type: %v", r.recordsType) @@ -89,11 +89,11 @@ func (r *Records) decode(pd packetDecoder) error { switch r.recordsType { case legacyRecords: - r.msgSet = &MessageSet{} - return r.msgSet.decode(pd) + r.MsgSet = &MessageSet{} + return r.MsgSet.decode(pd) case defaultRecords: - r.recordBatch = &RecordBatch{} - return r.recordBatch.decode(pd) + r.RecordBatch = &RecordBatch{} + return r.RecordBatch.decode(pd) } return fmt.Errorf("unknown records type: %v", r.recordsType) } @@ -107,15 +107,15 @@ func (r *Records) numRecords() (int, error) { switch r.recordsType { case legacyRecords: - if r.msgSet == nil { + if r.MsgSet == nil { return 0, nil } - return len(r.msgSet.Messages), nil + return len(r.MsgSet.Messages), nil case defaultRecords: - if r.recordBatch == nil { + if r.RecordBatch == nil { return 0, nil } - return len(r.recordBatch.Records), nil + return len(r.RecordBatch.Records), nil } return 0, fmt.Errorf("unknown records type: %v", r.recordsType) } @@ -131,15 +131,15 @@ func (r *Records) isPartial() (bool, error) { case unknownRecords: return false, nil case legacyRecords: - if r.msgSet == nil { + if r.MsgSet == nil { return false, nil } - return r.msgSet.PartialTrailingMessage, nil + return r.MsgSet.PartialTrailingMessage, nil case defaultRecords: - if r.recordBatch == nil { + if r.RecordBatch == nil { return false, nil } - return r.recordBatch.PartialTrailingRecord, nil + return r.RecordBatch.PartialTrailingRecord, nil } return false, fmt.Errorf("unknown records type: %v", r.recordsType) } @@ -155,10 +155,10 @@ func (r *Records) isControl() (bool, error) { case legacyRecords: return false, nil case defaultRecords: - if r.recordBatch == nil { + if r.RecordBatch == nil { return false, nil } - return r.recordBatch.Control, nil + return r.RecordBatch.Control, nil } return false, fmt.Errorf("unknown records type: %v", r.recordsType) } diff --git a/vendor/github.com/Shopify/sarama/request.go b/vendor/github.com/Shopify/sarama/request.go index 5f7cb76e95b4..4d211a14f173 100644 --- a/vendor/github.com/Shopify/sarama/request.go +++ b/vendor/github.com/Shopify/sarama/request.go @@ -97,7 +97,7 @@ func allocateBody(key, version int16) protocolBody { case 9: return &OffsetFetchRequest{} case 10: - return &ConsumerMetadataRequest{} + return &FindCoordinatorRequest{} case 11: return &JoinGroupRequest{} case 12: @@ -118,6 +118,8 @@ func allocateBody(key, version int16) protocolBody { return &CreateTopicsRequest{} case 20: return &DeleteTopicsRequest{} + case 21: + return &DeleteRecordsRequest{} case 22: return &InitProducerIDRequest{} case 24: @@ -140,6 +142,8 @@ func allocateBody(key, version int16) protocolBody { return &AlterConfigsRequest{} case 37: return &CreatePartitionsRequest{} + case 42: + return &DeleteGroupsRequest{} } return nil } diff --git a/vendor/github.com/Shopify/sarama/utils.go b/vendor/github.com/Shopify/sarama/utils.go index 9d7b60f16148..702e22627015 100644 --- a/vendor/github.com/Shopify/sarama/utils.go +++ b/vendor/github.com/Shopify/sarama/utils.go @@ -139,21 +139,49 @@ func (v KafkaVersion) IsAtLeast(other KafkaVersion) bool { // Effective constants defining the supported kafka versions. var ( - V0_8_2_0 = newKafkaVersion(0, 8, 2, 0) - V0_8_2_1 = newKafkaVersion(0, 8, 2, 1) - V0_8_2_2 = newKafkaVersion(0, 8, 2, 2) - V0_9_0_0 = newKafkaVersion(0, 9, 0, 0) - V0_9_0_1 = newKafkaVersion(0, 9, 0, 1) - V0_10_0_0 = newKafkaVersion(0, 10, 0, 0) - V0_10_0_1 = newKafkaVersion(0, 10, 0, 1) - V0_10_1_0 = newKafkaVersion(0, 10, 1, 0) - V0_10_2_0 = newKafkaVersion(0, 10, 2, 0) - V0_11_0_0 = newKafkaVersion(0, 11, 0, 0) - V1_0_0_0 = newKafkaVersion(1, 0, 0, 0) - minVersion = V0_8_2_0 + V0_8_2_0 = newKafkaVersion(0, 8, 2, 0) + V0_8_2_1 = newKafkaVersion(0, 8, 2, 1) + V0_8_2_2 = newKafkaVersion(0, 8, 2, 2) + V0_9_0_0 = newKafkaVersion(0, 9, 0, 0) + V0_9_0_1 = newKafkaVersion(0, 9, 0, 1) + V0_10_0_0 = newKafkaVersion(0, 10, 0, 0) + V0_10_0_1 = newKafkaVersion(0, 10, 0, 1) + V0_10_1_0 = newKafkaVersion(0, 10, 1, 0) + V0_10_1_1 = newKafkaVersion(0, 10, 1, 1) + V0_10_2_0 = newKafkaVersion(0, 10, 2, 0) + V0_10_2_1 = newKafkaVersion(0, 10, 2, 1) + V0_11_0_0 = newKafkaVersion(0, 11, 0, 0) + V0_11_0_1 = newKafkaVersion(0, 11, 0, 1) + V0_11_0_2 = newKafkaVersion(0, 11, 0, 2) + V1_0_0_0 = newKafkaVersion(1, 0, 0, 0) + V1_1_0_0 = newKafkaVersion(1, 1, 0, 0) + + SupportedVersions = []KafkaVersion{ + V0_8_2_0, + V0_8_2_1, + V0_8_2_2, + V0_9_0_0, + V0_9_0_1, + V0_10_0_0, + V0_10_0_1, + V0_10_1_0, + V0_10_1_1, + V0_10_2_0, + V0_10_2_1, + V0_11_0_0, + V0_11_0_1, + V0_11_0_2, + V1_0_0_0, + V1_1_0_0, + } + MinVersion = V0_8_2_0 + MaxVersion = V1_1_0_0 ) func ParseKafkaVersion(s string) (KafkaVersion, error) { + if len(s) < 5 { + return MinVersion, fmt.Errorf("invalid version `%s`", s) + } var major, minor, veryMinor, patch uint var err error if s[0] == '0' { @@ -162,7 +190,7 @@ func ParseKafkaVersion(s string) (KafkaVersion, error) { err = scanKafkaVersion(s, `^\d+\.\d+\.\d+$`, "%d.%d.%d", [3]*uint{&major, &minor, &veryMinor}) } if err != nil { - return minVersion, err + return MinVersion, err } return newKafkaVersion(major, minor, veryMinor, patch), nil } diff --git a/vendor/vendor.json b/vendor/vendor.json index f34c0e276f3a..0871db1b53f8 100644 --- a/vendor/vendor.json +++ b/vendor/vendor.json @@ -17,14 +17,14 @@ "versionExact": "v1.2.2" }, { - "checksumSHA1": "pH1jOw5Kfigc2tteo6KlaU9+JE8=", + "checksumSHA1": "xSwVjXDGIMoADDte4hBjra6ldGk=", "origin": "github.com/urso/sarama", "path": "github.com/Shopify/sarama", - "revision": "32b4ad5c9537ed14e471779b76713ff65420db39", + "revision": "d1575e4abe04acbbe8ac766320585cdf271dd189", "revisionTime": "2016-11-23T00:27:23Z", "tree": true, - "version": "v1.16.0/enh/offset-replica-id", - "versionExact": "v1.16.0/enh/offset-replica-id" + "version": "v1.17.0/enh/offset-replica-id", + "versionExact": "v1.17.0/enh/offset-replica-id" }, { "checksumSHA1": "DYv6Q1+VfnUVxMwvk5IshAClLvw=", diff --git a/winlogbeat/winlogbeat.reference.yml b/winlogbeat/winlogbeat.reference.yml index 563748360c26..c4ad07387e86 100644 --- a/winlogbeat/winlogbeat.reference.yml +++ b/winlogbeat/winlogbeat.reference.yml @@ -538,6 +538,10 @@ output.elasticsearch: # default is gzip. #compression: gzip + # Set the compression level. Currently only gzip provides a compression level + # between 0 and 9. The default value is chosen by the compression algorithm. + #compression_level: 4 + # The maximum permitted size of JSON-encoded messages. Bigger messages will be # dropped. The default value is 1000000 (bytes). This value should be equal to # or less than the broker's message.max.bytes. From 7cd81b1bf0fb08edb76e9bec8b4d718fa99e04ca Mon Sep 17 00:00:00 2001 From: Andrew Kroh Date: Mon, 23 Jul 2018 10:49:12 -0400 Subject: [PATCH 29/34] Update github.com/OneOfOne/xxhash to fix mips --- NOTICE.txt | 3 +-- vendor/github.com/OneOfOne/xxhash/xxhash_safe.go | 2 +- vendor/github.com/OneOfOne/xxhash/xxhash_unsafe.go | 2 +- vendor/vendor.json | 9 ++++----- 4 files changed, 7 insertions(+), 9 deletions(-) diff --git a/NOTICE.txt b/NOTICE.txt index 2e926de1e3d5..a201c2d15111 100644 --- a/NOTICE.txt +++ b/NOTICE.txt @@ -1638,8 +1638,7 @@ THE SOFTWARE. -------------------------------------------------------------------- Dependency: github.com/OneOfOne/xxhash -Version: v1.2.2 -Revision: 6def279d2ce6c81a79dd1c1be580f03bb216fb8a +Revision: 2c166c65de755bdafa6ae2959c10ea9df6e8b3e5 License type (autodetected): Apache-2.0 ./vendor/github.com/OneOfOne/xxhash/LICENSE: -------------------------------------------------------------------- diff --git a/vendor/github.com/OneOfOne/xxhash/xxhash_safe.go b/vendor/github.com/OneOfOne/xxhash/xxhash_safe.go index 7532c2d31ecb..81b63cdb559c 100644 --- a/vendor/github.com/OneOfOne/xxhash/xxhash_safe.go +++ b/vendor/github.com/OneOfOne/xxhash/xxhash_safe.go @@ -1,4 +1,4 @@ -// +build appengine safe ppc64le ppc64be mipsle mipsbe +// +build appengine safe ppc64le ppc64be mipsle mips package xxhash diff --git a/vendor/github.com/OneOfOne/xxhash/xxhash_unsafe.go b/vendor/github.com/OneOfOne/xxhash/xxhash_unsafe.go index caacdc8b5a2c..42d2d35f503f 100644 --- a/vendor/github.com/OneOfOne/xxhash/xxhash_unsafe.go +++ b/vendor/github.com/OneOfOne/xxhash/xxhash_unsafe.go @@ -3,7 +3,7 @@ // +build !ppc64le // +build !mipsle // +build !ppc64be -// +build !mipsbe +// +build !mips package xxhash diff --git a/vendor/vendor.json b/vendor/vendor.json index 0871db1b53f8..476482e1f168 100644 --- a/vendor/vendor.json +++ b/vendor/vendor.json @@ -9,12 +9,11 @@ "revisionTime": "2017-05-24T00:36:31Z" }, { - "checksumSHA1": "wshQ6/MnQx8nH6pgufu4kJEX6JI=", + "checksumSHA1": "rDoYEddGYvQT73l9V8Uqjk7SHAY=", + "origin": "github.com/andrewkroh/xxhash", "path": "github.com/OneOfOne/xxhash", - "revision": "6def279d2ce6c81a79dd1c1be580f03bb216fb8a", - "revisionTime": "2018-05-30T13:49:54Z", - "version": "v1.2.2", - "versionExact": "v1.2.2" + "revision": "2c166c65de755bdafa6ae2959c10ea9df6e8b3e5", + "revisionTime": "2018-07-23T14:32:41Z" }, { "checksumSHA1": "xSwVjXDGIMoADDte4hBjra6ldGk=", From 2b142fa8bfbecebb46b7adba5fc1da4d10f4ece3 Mon Sep 17 00:00:00 2001 From: Andrew Kroh Date: Mon, 23 Jul 2018 10:53:38 -0400 Subject: [PATCH 30/34] Update boltdb to use github.com/coreos/bbolt fork Closes #6052 --- NOTICE.txt | 7 +- auditbeat/datastore/datastore.go | 2 +- auditbeat/module/file_integrity/metricset.go | 2 +- vendor/github.com/boltdb/bolt/Makefile | 18 -- vendor/github.com/boltdb/bolt/appveyor.yml | 18 -- .../{boltdb/bolt => coreos/bbolt}/LICENSE | 0 vendor/github.com/coreos/bbolt/Makefile | 30 +++ .../{boltdb/bolt => coreos/bbolt}/README.md | 24 +- .../{boltdb/bolt => coreos/bbolt}/bolt_386.go | 0 .../bolt => coreos/bbolt}/bolt_amd64.go | 0 .../{boltdb/bolt => coreos/bbolt}/bolt_arm.go | 0 .../bolt => coreos/bbolt}/bolt_arm64.go | 0 .../bolt => coreos/bbolt}/bolt_linux.go | 0 .../github.com/coreos/bbolt/bolt_mips64x.go | 12 + vendor/github.com/coreos/bbolt/bolt_mipsx.go | 12 + .../bolt => coreos/bbolt}/bolt_openbsd.go | 0 .../{boltdb/bolt => coreos/bbolt}/bolt_ppc.go | 3 + .../bolt => coreos/bbolt}/bolt_ppc64.go | 0 .../bolt => coreos/bbolt}/bolt_ppc64le.go | 0 .../bolt => coreos/bbolt}/bolt_s390x.go | 0 .../bolt => coreos/bbolt}/bolt_unix.go | 37 +-- .../bbolt}/bolt_unix_solaris.go | 39 ++-- .../bolt => coreos/bbolt}/bolt_windows.go | 31 +-- .../bolt => coreos/bbolt}/boltsync_unix.go | 0 .../{boltdb/bolt => coreos/bbolt}/bucket.go | 14 +- .../{boltdb/bolt => coreos/bbolt}/cursor.go | 8 +- .../{boltdb/bolt => coreos/bbolt}/db.go | 211 +++++++++++++----- .../{boltdb/bolt => coreos/bbolt}/doc.go | 0 .../{boltdb/bolt => coreos/bbolt}/errors.go | 0 .../{boltdb/bolt => coreos/bbolt}/freelist.go | 131 ++++++++--- .../{boltdb/bolt => coreos/bbolt}/node.go | 2 +- .../{boltdb/bolt => coreos/bbolt}/page.go | 0 .../{boltdb/bolt => coreos/bbolt}/tx.go | 83 ++++--- vendor/vendor.json | 10 +- 34 files changed, 464 insertions(+), 230 deletions(-) delete mode 100644 vendor/github.com/boltdb/bolt/Makefile delete mode 100644 vendor/github.com/boltdb/bolt/appveyor.yml rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/LICENSE (100%) create mode 100644 vendor/github.com/coreos/bbolt/Makefile rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/README.md (96%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_386.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_amd64.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_arm.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_arm64.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_linux.go (100%) create mode 100644 vendor/github.com/coreos/bbolt/bolt_mips64x.go create mode 100644 vendor/github.com/coreos/bbolt/bolt_mipsx.go rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_openbsd.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_ppc.go (74%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_ppc64.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_ppc64le.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_s390x.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_unix.go (75%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_unix_solaris.go (75%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bolt_windows.go (89%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/boltsync_unix.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/bucket.go (99%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/cursor.go (99%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/db.go (85%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/doc.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/errors.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/freelist.go (65%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/node.go (99%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/page.go (100%) rename vendor/github.com/{boltdb/bolt => coreos/bbolt}/tx.go (94%) diff --git a/NOTICE.txt b/NOTICE.txt index a201c2d15111..bfbb7db2017e 100644 --- a/NOTICE.txt +++ b/NOTICE.txt @@ -116,11 +116,10 @@ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. -------------------------------------------------------------------- -Dependency: github.com/boltdb/bolt -Version: v1.3.1 -Revision: 2f1ce7a837dcb8da3ec595b1dac9d0632f0f99e8 +Dependency: github.com/coreos/bbolt +Revision: af9db2027c98c61ecd8e17caa5bd265792b9b9a2 License type (autodetected): MIT -./vendor/github.com/boltdb/bolt/LICENSE: +./vendor/github.com/coreos/bbolt/LICENSE: -------------------------------------------------------------------- The MIT License (MIT) diff --git a/auditbeat/datastore/datastore.go b/auditbeat/datastore/datastore.go index 46b3d3d6f42f..018897ee7bfd 100644 --- a/auditbeat/datastore/datastore.go +++ b/auditbeat/datastore/datastore.go @@ -22,7 +22,7 @@ import ( "os" "sync" - "github.com/boltdb/bolt" + bolt "github.com/coreos/bbolt" "github.com/elastic/beats/libbeat/paths" ) diff --git a/auditbeat/module/file_integrity/metricset.go b/auditbeat/module/file_integrity/metricset.go index fa18179aa6c7..23bbe133f91d 100644 --- a/auditbeat/module/file_integrity/metricset.go +++ b/auditbeat/module/file_integrity/metricset.go @@ -22,7 +22,7 @@ import ( "os" "time" - "github.com/boltdb/bolt" + bolt "github.com/coreos/bbolt" "github.com/pkg/errors" "github.com/elastic/beats/auditbeat/datastore" diff --git a/vendor/github.com/boltdb/bolt/Makefile b/vendor/github.com/boltdb/bolt/Makefile deleted file mode 100644 index e035e63adcd7..000000000000 --- a/vendor/github.com/boltdb/bolt/Makefile +++ /dev/null @@ -1,18 +0,0 @@ -BRANCH=`git rev-parse --abbrev-ref HEAD` -COMMIT=`git rev-parse --short HEAD` -GOLDFLAGS="-X main.branch $(BRANCH) -X main.commit $(COMMIT)" - -default: build - -race: - @go test -v -race -test.run="TestSimulate_(100op|1000op)" - -# go get github.com/kisielk/errcheck -errcheck: - @errcheck -ignorepkg=bytes -ignore=os:Remove github.com/boltdb/bolt - -test: - @go test -v -cover . - @go test -v ./cmd/bolt - -.PHONY: fmt test diff --git a/vendor/github.com/boltdb/bolt/appveyor.yml b/vendor/github.com/boltdb/bolt/appveyor.yml deleted file mode 100644 index 6e26e941d682..000000000000 --- a/vendor/github.com/boltdb/bolt/appveyor.yml +++ /dev/null @@ -1,18 +0,0 @@ -version: "{build}" - -os: Windows Server 2012 R2 - -clone_folder: c:\gopath\src\github.com\boltdb\bolt - -environment: - GOPATH: c:\gopath - -install: - - echo %PATH% - - echo %GOPATH% - - go version - - go env - - go get -v -t ./... - -build_script: - - go test -v ./... diff --git a/vendor/github.com/boltdb/bolt/LICENSE b/vendor/github.com/coreos/bbolt/LICENSE similarity index 100% rename from vendor/github.com/boltdb/bolt/LICENSE rename to vendor/github.com/coreos/bbolt/LICENSE diff --git a/vendor/github.com/coreos/bbolt/Makefile b/vendor/github.com/coreos/bbolt/Makefile new file mode 100644 index 000000000000..43b94f3bdfe8 --- /dev/null +++ b/vendor/github.com/coreos/bbolt/Makefile @@ -0,0 +1,30 @@ +BRANCH=`git rev-parse --abbrev-ref HEAD` +COMMIT=`git rev-parse --short HEAD` +GOLDFLAGS="-X main.branch $(BRANCH) -X main.commit $(COMMIT)" + +default: build + +race: + @go test -v -race -test.run="TestSimulate_(100op|1000op)" + +fmt: + !(gofmt -l -s -d $(shell find . -name \*.go) | grep '[a-z]') + +# go get honnef.co/go/tools/simple +gosimple: + gosimple ./... + +# go get honnef.co/go/tools/unused +unused: + unused ./... + +# go get github.com/kisielk/errcheck +errcheck: + @errcheck -ignorepkg=bytes -ignore=os:Remove github.com/coreos/bbolt + +test: + go test -timeout 20m -v -coverprofile cover.out -covermode atomic + # Note: gets "program not an importable package" in out of path builds + go test -v ./cmd/bolt + +.PHONY: race fmt errcheck test gosimple unused diff --git a/vendor/github.com/boltdb/bolt/README.md b/vendor/github.com/coreos/bbolt/README.md similarity index 96% rename from vendor/github.com/boltdb/bolt/README.md rename to vendor/github.com/coreos/bbolt/README.md index 7d43a15b2c20..015f0efbe845 100644 --- a/vendor/github.com/boltdb/bolt/README.md +++ b/vendor/github.com/coreos/bbolt/README.md @@ -1,6 +1,16 @@ -Bolt [![Coverage Status](https://coveralls.io/repos/boltdb/bolt/badge.svg?branch=master)](https://coveralls.io/r/boltdb/bolt?branch=master) [![GoDoc](https://godoc.org/github.com/boltdb/bolt?status.svg)](https://godoc.org/github.com/boltdb/bolt) ![Version](https://img.shields.io/badge/version-1.2.1-green.svg) +bbolt ==== +[![Go Report Card](https://goreportcard.com/badge/github.com/coreos/bbolt?style=flat-square)](https://goreportcard.com/report/github.com/coreos/bbolt) +[![Coverage](https://codecov.io/gh/coreos/bbolt/branch/master/graph/badge.svg)](https://codecov.io/gh/coreos/bbolt) +[![Godoc](http://img.shields.io/badge/go-documentation-blue.svg?style=flat-square)](https://godoc.org/github.com/coreos/bbolt) + +bbolt is a fork of [Ben Johnson's][gh_ben] [Bolt][bolt] key/value +store. The purpose of this fork is to provide the Go community with an active +maintenance and development target for Bolt; the goal is improved reliability +and stability. bbolt includes bug fixes, performance enhancements, and features +not found in Bolt while preserving backwards compatibility with the Bolt API. + Bolt is a pure Go key/value store inspired by [Howard Chu's][hyc_symas] [LMDB project][lmdb]. The goal of the project is to provide a simple, fast, and reliable database for projects that don't require a full database @@ -10,6 +20,8 @@ Since Bolt is meant to be used as such a low-level piece of functionality, simplicity is key. The API will be small and only focus on getting values and setting values. That's it. +[gh_ben]: https://github.com/benbjohnson +[bolt]: https://github.com/boltdb/bolt [hyc_symas]: https://twitter.com/hyc_symas [lmdb]: http://symas.com/mdb/ @@ -59,7 +71,7 @@ Shopify and Heroku use Bolt-backed services every day. To start using Bolt, install Go and run `go get`: ```sh -$ go get github.com/boltdb/bolt/... +$ go get github.com/coreos/bbolt/... ``` This will retrieve the library and install the `bolt` command line utility into @@ -79,7 +91,7 @@ package main import ( "log" - "github.com/boltdb/bolt" + bolt "github.com/coreos/bbolt" ) func main() { @@ -522,7 +534,7 @@ this from a read-only transaction, it will perform a hot backup and not block your other database reads and writes. By default, it will use a regular file handle which will utilize the operating -system's page cache. See the [`Tx`](https://godoc.org/github.com/boltdb/bolt#Tx) +system's page cache. See the [`Tx`](https://godoc.org/github.com/coreos/bbolt#Tx) documentation for information about optimizing for larger-than-RAM datasets. One common use case is to backup over HTTP so you can use tools like `cURL` to @@ -811,7 +823,7 @@ Here are a few things to note when evaluating and using Bolt: ## Reading the Source -Bolt is a relatively small code base (<3KLOC) for an embedded, serializable, +Bolt is a relatively small code base (<5KLOC) for an embedded, serializable, transactional key/value database so it can be a good starting point for people interested in how databases work. @@ -907,10 +919,10 @@ Below is a list of public, open source projects that use Bolt: * [torrent](https://github.com/anacrolix/torrent) - Full-featured BitTorrent client package and utilities in Go. BoltDB is a storage backend in development. * [gopherpit](https://github.com/gopherpit/gopherpit) - A web service to manage Go remote import paths with custom domains * [bolter](https://github.com/hasit/bolter) - Command-line app for viewing BoltDB file in your terminal. +* [boltcli](https://github.com/spacewander/boltcli) - the redis-cli for boltdb with Lua script support. * [btcwallet](https://github.com/btcsuite/btcwallet) - A bitcoin wallet. * [dcrwallet](https://github.com/decred/dcrwallet) - A wallet for the Decred cryptocurrency. * [Ironsmith](https://github.com/timshannon/ironsmith) - A simple, script-driven continuous integration (build - > test -> release) tool, with no external dependencies * [BoltHold](https://github.com/timshannon/bolthold) - An embeddable NoSQL store for Go types built on BoltDB -* [Ponzu CMS](https://ponzu-cms.org) - Headless CMS + automatic JSON API with auto-HTTPS, HTTP/2 Server Push, and flexible server framework. If you are using Bolt in a project please send a pull request to add it to the list. diff --git a/vendor/github.com/boltdb/bolt/bolt_386.go b/vendor/github.com/coreos/bbolt/bolt_386.go similarity index 100% rename from vendor/github.com/boltdb/bolt/bolt_386.go rename to vendor/github.com/coreos/bbolt/bolt_386.go diff --git a/vendor/github.com/boltdb/bolt/bolt_amd64.go b/vendor/github.com/coreos/bbolt/bolt_amd64.go similarity index 100% rename from vendor/github.com/boltdb/bolt/bolt_amd64.go rename to vendor/github.com/coreos/bbolt/bolt_amd64.go diff --git a/vendor/github.com/boltdb/bolt/bolt_arm.go b/vendor/github.com/coreos/bbolt/bolt_arm.go similarity index 100% rename from vendor/github.com/boltdb/bolt/bolt_arm.go rename to vendor/github.com/coreos/bbolt/bolt_arm.go diff --git a/vendor/github.com/boltdb/bolt/bolt_arm64.go b/vendor/github.com/coreos/bbolt/bolt_arm64.go similarity index 100% rename from vendor/github.com/boltdb/bolt/bolt_arm64.go rename to vendor/github.com/coreos/bbolt/bolt_arm64.go diff --git a/vendor/github.com/boltdb/bolt/bolt_linux.go b/vendor/github.com/coreos/bbolt/bolt_linux.go similarity index 100% rename from vendor/github.com/boltdb/bolt/bolt_linux.go rename to vendor/github.com/coreos/bbolt/bolt_linux.go diff --git a/vendor/github.com/coreos/bbolt/bolt_mips64x.go b/vendor/github.com/coreos/bbolt/bolt_mips64x.go new file mode 100644 index 000000000000..134b578bd447 --- /dev/null +++ b/vendor/github.com/coreos/bbolt/bolt_mips64x.go @@ -0,0 +1,12 @@ +// +build mips64 mips64le + +package bolt + +// maxMapSize represents the largest mmap size supported by Bolt. +const maxMapSize = 0x8000000000 // 512GB + +// maxAllocSize is the size used when creating array pointers. +const maxAllocSize = 0x7FFFFFFF + +// Are unaligned load/stores broken on this arch? +var brokenUnaligned = false diff --git a/vendor/github.com/coreos/bbolt/bolt_mipsx.go b/vendor/github.com/coreos/bbolt/bolt_mipsx.go new file mode 100644 index 000000000000..d5ecb0597e45 --- /dev/null +++ b/vendor/github.com/coreos/bbolt/bolt_mipsx.go @@ -0,0 +1,12 @@ +// +build mips mipsle + +package bolt + +// maxMapSize represents the largest mmap size supported by Bolt. +const maxMapSize = 0x40000000 // 1GB + +// maxAllocSize is the size used when creating array pointers. +const maxAllocSize = 0xFFFFFFF + +// Are unaligned load/stores broken on this arch? +var brokenUnaligned = false diff --git a/vendor/github.com/boltdb/bolt/bolt_openbsd.go b/vendor/github.com/coreos/bbolt/bolt_openbsd.go similarity index 100% rename from vendor/github.com/boltdb/bolt/bolt_openbsd.go rename to vendor/github.com/coreos/bbolt/bolt_openbsd.go diff --git a/vendor/github.com/boltdb/bolt/bolt_ppc.go b/vendor/github.com/coreos/bbolt/bolt_ppc.go similarity index 74% rename from vendor/github.com/boltdb/bolt/bolt_ppc.go rename to vendor/github.com/coreos/bbolt/bolt_ppc.go index 645ddc3edc2d..55cb8a72cc0e 100644 --- a/vendor/github.com/boltdb/bolt/bolt_ppc.go +++ b/vendor/github.com/coreos/bbolt/bolt_ppc.go @@ -7,3 +7,6 @@ const maxMapSize = 0x7FFFFFFF // 2GB // maxAllocSize is the size used when creating array pointers. const maxAllocSize = 0xFFFFFFF + +// Are unaligned load/stores broken on this arch? +var brokenUnaligned = false diff --git a/vendor/github.com/boltdb/bolt/bolt_ppc64.go b/vendor/github.com/coreos/bbolt/bolt_ppc64.go similarity index 100% rename from vendor/github.com/boltdb/bolt/bolt_ppc64.go rename to vendor/github.com/coreos/bbolt/bolt_ppc64.go diff --git a/vendor/github.com/boltdb/bolt/bolt_ppc64le.go b/vendor/github.com/coreos/bbolt/bolt_ppc64le.go similarity index 100% rename from vendor/github.com/boltdb/bolt/bolt_ppc64le.go rename to vendor/github.com/coreos/bbolt/bolt_ppc64le.go diff --git a/vendor/github.com/boltdb/bolt/bolt_s390x.go b/vendor/github.com/coreos/bbolt/bolt_s390x.go similarity index 100% rename from vendor/github.com/boltdb/bolt/bolt_s390x.go rename to vendor/github.com/coreos/bbolt/bolt_s390x.go diff --git a/vendor/github.com/boltdb/bolt/bolt_unix.go b/vendor/github.com/coreos/bbolt/bolt_unix.go similarity index 75% rename from vendor/github.com/boltdb/bolt/bolt_unix.go rename to vendor/github.com/coreos/bbolt/bolt_unix.go index cad62dda1e38..add3bd8823ca 100644 --- a/vendor/github.com/boltdb/bolt/bolt_unix.go +++ b/vendor/github.com/coreos/bbolt/bolt_unix.go @@ -13,29 +13,32 @@ import ( // flock acquires an advisory lock on a file descriptor. func flock(db *DB, mode os.FileMode, exclusive bool, timeout time.Duration) error { var t time.Time + if timeout != 0 { + t = time.Now() + } + fd := db.file.Fd() + flag := syscall.LOCK_NB + if exclusive { + flag |= syscall.LOCK_EX + } else { + flag |= syscall.LOCK_SH + } for { - // If we're beyond our timeout then return an error. - // This can only occur after we've attempted a flock once. - if t.IsZero() { - t = time.Now() - } else if timeout > 0 && time.Since(t) > timeout { - return ErrTimeout - } - flag := syscall.LOCK_SH - if exclusive { - flag = syscall.LOCK_EX - } - - // Otherwise attempt to obtain an exclusive lock. - err := syscall.Flock(int(db.file.Fd()), flag|syscall.LOCK_NB) + // Attempt to obtain an exclusive lock. + err := syscall.Flock(int(fd), flag) if err == nil { return nil } else if err != syscall.EWOULDBLOCK { return err } + // If we timed out then return an error. + if timeout != 0 && time.Since(t) > timeout-flockRetryTimeout { + return ErrTimeout + } + // Wait for a bit and try again. - time.Sleep(50 * time.Millisecond) + time.Sleep(flockRetryTimeout) } } @@ -53,7 +56,9 @@ func mmap(db *DB, sz int) error { } // Advise the kernel that the mmap is accessed randomly. - if err := madvise(b, syscall.MADV_RANDOM); err != nil { + err = madvise(b, syscall.MADV_RANDOM) + if err != nil && err != syscall.ENOSYS { + // Ignore not implemented error in kernel because it still works. return fmt.Errorf("madvise: %s", err) } diff --git a/vendor/github.com/boltdb/bolt/bolt_unix_solaris.go b/vendor/github.com/coreos/bbolt/bolt_unix_solaris.go similarity index 75% rename from vendor/github.com/boltdb/bolt/bolt_unix_solaris.go rename to vendor/github.com/coreos/bbolt/bolt_unix_solaris.go index 307bf2b3ee97..fd8335ecc963 100644 --- a/vendor/github.com/boltdb/bolt/bolt_unix_solaris.go +++ b/vendor/github.com/coreos/bbolt/bolt_unix_solaris.go @@ -13,34 +13,33 @@ import ( // flock acquires an advisory lock on a file descriptor. func flock(db *DB, mode os.FileMode, exclusive bool, timeout time.Duration) error { var t time.Time + if timeout != 0 { + t = time.Now() + } + fd := db.file.Fd() + var lockType int16 + if exclusive { + lockType = syscall.F_WRLCK + } else { + lockType = syscall.F_RDLCK + } for { - // If we're beyond our timeout then return an error. - // This can only occur after we've attempted a flock once. - if t.IsZero() { - t = time.Now() - } else if timeout > 0 && time.Since(t) > timeout { - return ErrTimeout - } - var lock syscall.Flock_t - lock.Start = 0 - lock.Len = 0 - lock.Pid = 0 - lock.Whence = 0 - lock.Pid = 0 - if exclusive { - lock.Type = syscall.F_WRLCK - } else { - lock.Type = syscall.F_RDLCK - } - err := syscall.FcntlFlock(db.file.Fd(), syscall.F_SETLK, &lock) + // Attempt to obtain an exclusive lock. + lock := syscall.Flock_t{Type: lockType} + err := syscall.FcntlFlock(fd, syscall.F_SETLK, &lock) if err == nil { return nil } else if err != syscall.EAGAIN { return err } + // If we timed out then return an error. + if timeout != 0 && time.Since(t) > timeout-flockRetryTimeout { + return ErrTimeout + } + // Wait for a bit and try again. - time.Sleep(50 * time.Millisecond) + time.Sleep(flockRetryTimeout) } } diff --git a/vendor/github.com/boltdb/bolt/bolt_windows.go b/vendor/github.com/coreos/bbolt/bolt_windows.go similarity index 89% rename from vendor/github.com/boltdb/bolt/bolt_windows.go rename to vendor/github.com/coreos/bbolt/bolt_windows.go index b00fb0720a42..ca6f9a11c241 100644 --- a/vendor/github.com/boltdb/bolt/bolt_windows.go +++ b/vendor/github.com/coreos/bbolt/bolt_windows.go @@ -59,29 +59,30 @@ func flock(db *DB, mode os.FileMode, exclusive bool, timeout time.Duration) erro db.lockfile = f var t time.Time + if timeout != 0 { + t = time.Now() + } + fd := f.Fd() + var flag uint32 = flagLockFailImmediately + if exclusive { + flag |= flagLockExclusive + } for { - // If we're beyond our timeout then return an error. - // This can only occur after we've attempted a flock once. - if t.IsZero() { - t = time.Now() - } else if timeout > 0 && time.Since(t) > timeout { - return ErrTimeout - } - - var flag uint32 = flagLockFailImmediately - if exclusive { - flag |= flagLockExclusive - } - - err := lockFileEx(syscall.Handle(db.lockfile.Fd()), flag, 0, 1, 0, &syscall.Overlapped{}) + // Attempt to obtain an exclusive lock. + err := lockFileEx(syscall.Handle(fd), flag, 0, 1, 0, &syscall.Overlapped{}) if err == nil { return nil } else if err != errLockViolation { return err } + // If we timed oumercit then return an error. + if timeout != 0 && time.Since(t) > timeout-flockRetryTimeout { + return ErrTimeout + } + // Wait for a bit and try again. - time.Sleep(50 * time.Millisecond) + time.Sleep(flockRetryTimeout) } } diff --git a/vendor/github.com/boltdb/bolt/boltsync_unix.go b/vendor/github.com/coreos/bbolt/boltsync_unix.go similarity index 100% rename from vendor/github.com/boltdb/bolt/boltsync_unix.go rename to vendor/github.com/coreos/bbolt/boltsync_unix.go diff --git a/vendor/github.com/boltdb/bolt/bucket.go b/vendor/github.com/coreos/bbolt/bucket.go similarity index 99% rename from vendor/github.com/boltdb/bolt/bucket.go rename to vendor/github.com/coreos/bbolt/bucket.go index 0c5bf27463e1..44db88b8abde 100644 --- a/vendor/github.com/boltdb/bolt/bucket.go +++ b/vendor/github.com/coreos/bbolt/bucket.go @@ -14,13 +14,6 @@ const ( MaxValueSize = (1 << 31) - 2 ) -const ( - maxUint = ^uint(0) - minUint = 0 - maxInt = int(^uint(0) >> 1) - minInt = -maxInt - 1 -) - const bucketHeaderSize = int(unsafe.Sizeof(bucket{})) const ( @@ -323,7 +316,12 @@ func (b *Bucket) Delete(key []byte) error { // Move cursor to correct position. c := b.Cursor() - _, _, flags := c.seek(key) + k, _, flags := c.seek(key) + + // Return nil if the key doesn't exist. + if !bytes.Equal(key, k) { + return nil + } // Return an error if there is already existing bucket value. if (flags & bucketLeafFlag) != 0 { diff --git a/vendor/github.com/boltdb/bolt/cursor.go b/vendor/github.com/coreos/bbolt/cursor.go similarity index 99% rename from vendor/github.com/boltdb/bolt/cursor.go rename to vendor/github.com/coreos/bbolt/cursor.go index 1be9f35e3ef8..1bdda63a2f42 100644 --- a/vendor/github.com/boltdb/bolt/cursor.go +++ b/vendor/github.com/coreos/bbolt/cursor.go @@ -157,12 +157,6 @@ func (c *Cursor) seek(seek []byte) (key []byte, value []byte, flags uint32) { // Start from root page/node and traverse to correct page. c.stack = c.stack[:0] c.search(seek, c.bucket.root) - ref := &c.stack[len(c.stack)-1] - - // If the cursor is pointing to the end of page/node then return nil. - if ref.index >= ref.count() { - return nil, nil, 0 - } // If this is a bucket then return a nil value. return c.keyValue() @@ -339,6 +333,8 @@ func (c *Cursor) nsearch(key []byte) { // keyValue returns the key and value of the current leaf element. func (c *Cursor) keyValue() ([]byte, []byte, uint32) { ref := &c.stack[len(c.stack)-1] + + // If the cursor is pointing to the end of page/node then return nil. if ref.count() == 0 || ref.index >= ref.count() { return nil, nil, 0 } diff --git a/vendor/github.com/boltdb/bolt/db.go b/vendor/github.com/coreos/bbolt/db.go similarity index 85% rename from vendor/github.com/boltdb/bolt/db.go rename to vendor/github.com/coreos/bbolt/db.go index f352ff14fe40..ab97c6014aa1 100644 --- a/vendor/github.com/boltdb/bolt/db.go +++ b/vendor/github.com/coreos/bbolt/db.go @@ -7,8 +7,7 @@ import ( "log" "os" "runtime" - "runtime/debug" - "strings" + "sort" "sync" "time" "unsafe" @@ -23,6 +22,8 @@ const version = 2 // Represents a marker value to indicate that a file is a Bolt DB. const magic uint32 = 0xED0CDAED +const pgidNoFreelist pgid = 0xffffffffffffffff + // IgnoreNoSync specifies whether the NoSync field of a DB is ignored when // syncing changes to a file. This is required as some operating systems, // such as OpenBSD, do not have a unified buffer cache (UBC) and writes @@ -39,6 +40,9 @@ const ( // default page size for db is set to the OS page size. var defaultPageSize = os.Getpagesize() +// The time elapsed between consecutive file locking attempts. +const flockRetryTimeout = 50 * time.Millisecond + // DB represents a collection of buckets persisted to a file on disk. // All data access is performed through transactions which can be obtained through the DB. // All the functions on DB will return a ErrDatabaseNotOpen if accessed before Open() is called. @@ -61,6 +65,11 @@ type DB struct { // THIS IS UNSAFE. PLEASE USE WITH CAUTION. NoSync bool + // When true, skips syncing freelist to disk. This improves the database + // write performance under normal operation, but requires a full database + // re-sync during recovery. + NoFreelistSync bool + // When true, skips the truncate call when growing the database. // Setting this to true is only safe on non-ext3/ext4 systems. // Skipping truncation avoids preallocation of hard drive space and @@ -107,9 +116,11 @@ type DB struct { opened bool rwtx *Tx txs []*Tx - freelist *freelist stats Stats + freelist *freelist + freelistLoad sync.Once + pagePool sync.Pool batchMu sync.Mutex @@ -148,14 +159,17 @@ func (db *DB) String() string { // If the file does not exist then it will be created automatically. // Passing in nil options will cause Bolt to open the database with the default options. func Open(path string, mode os.FileMode, options *Options) (*DB, error) { - var db = &DB{opened: true} - + db := &DB{ + opened: true, + } // Set default options if no options are provided. if options == nil { options = DefaultOptions } + db.NoSync = options.NoSync db.NoGrowSync = options.NoGrowSync db.MmapFlags = options.MmapFlags + db.NoFreelistSync = options.NoFreelistSync // Set default values for later DB operations. db.MaxBatchSize = DefaultMaxBatchSize @@ -184,6 +198,7 @@ func Open(path string, mode os.FileMode, options *Options) (*DB, error) { // The database file is locked using the shared lock (more than one process may // hold a lock at the same time) otherwise (options.ReadOnly is set). if err := flock(db, mode, !db.readOnly, options.Timeout); err != nil { + db.lockfile = nil // make 'unused' happy. TODO: rework locks _ = db.close() return nil, err } @@ -191,31 +206,41 @@ func Open(path string, mode os.FileMode, options *Options) (*DB, error) { // Default values for test hooks db.ops.writeAt = db.file.WriteAt + if db.pageSize = options.PageSize; db.pageSize == 0 { + // Set the default page size to the OS page size. + db.pageSize = defaultPageSize + } + // Initialize the database if it doesn't exist. if info, err := db.file.Stat(); err != nil { + _ = db.close() return nil, err } else if info.Size() == 0 { // Initialize new files with meta pages. if err := db.init(); err != nil { + // clean up file descriptor on initialization fail + _ = db.close() return nil, err } } else { // Read the first meta page to determine the page size. var buf [0x1000]byte - if _, err := db.file.ReadAt(buf[:], 0); err == nil { - m := db.pageInBuffer(buf[:], 0).meta() - if err := m.validate(); err != nil { - // If we can't read the page size, we can assume it's the same - // as the OS -- since that's how the page size was chosen in the - // first place. - // - // If the first page is invalid and this OS uses a different - // page size than what the database was created with then we - // are out of luck and cannot access the database. - db.pageSize = os.Getpagesize() - } else { + // If we can't read the page size, but can read a page, assume + // it's the same as the OS or one given -- since that's how the + // page size was chosen in the first place. + // + // If the first page is invalid and this OS uses a different + // page size than what the database was created with then we + // are out of luck and cannot access the database. + // + // TODO: scan for next page + if bw, err := db.file.ReadAt(buf[:], 0); err == nil && bw == len(buf) { + if m := db.pageInBuffer(buf[:], 0).meta(); m.validate() == nil { db.pageSize = int(m.pageSize) } + } else { + _ = db.close() + return nil, ErrInvalid } } @@ -232,14 +257,50 @@ func Open(path string, mode os.FileMode, options *Options) (*DB, error) { return nil, err } - // Read in the freelist. - db.freelist = newFreelist() - db.freelist.read(db.page(db.meta().freelist)) + if db.readOnly { + return db, nil + } + + db.loadFreelist() + + // Flush freelist when transitioning from no sync to sync so + // NoFreelistSync unaware boltdb can open the db later. + if !db.NoFreelistSync && !db.hasSyncedFreelist() { + tx, err := db.Begin(true) + if tx != nil { + err = tx.Commit() + } + if err != nil { + _ = db.close() + return nil, err + } + } // Mark the database as opened and return. return db, nil } +// loadFreelist reads the freelist if it is synced, or reconstructs it +// by scanning the DB if it is not synced. It assumes there are no +// concurrent accesses being made to the freelist. +func (db *DB) loadFreelist() { + db.freelistLoad.Do(func() { + db.freelist = newFreelist() + if !db.hasSyncedFreelist() { + // Reconstruct free list by scanning the DB. + db.freelist.readIDs(db.freepages()) + } else { + // Read free list from freelist page. + db.freelist.read(db.page(db.meta().freelist)) + } + db.stats.FreePageN = len(db.freelist.ids) + }) +} + +func (db *DB) hasSyncedFreelist() bool { + return db.meta().freelist != pgidNoFreelist +} + // mmap opens the underlying memory-mapped file and initializes the meta references. // minsz is the minimum size that the new mmap can be. func (db *DB) mmap(minsz int) error { @@ -341,9 +402,6 @@ func (db *DB) mmapSize(size int) (int, error) { // init creates a new database file and initializes its meta pages. func (db *DB) init() error { - // Set the page size to the OS page size. - db.pageSize = os.Getpagesize() - // Create two meta pages on a buffer. buf := make([]byte, db.pageSize*4) for i := 0; i < 2; i++ { @@ -387,7 +445,8 @@ func (db *DB) init() error { } // Close releases all database resources. -// All transactions must be closed before closing the database. +// It will block waiting for any open transactions to finish +// before closing the database and returning. func (db *DB) Close() error { db.rwlock.Lock() defer db.rwlock.Unlock() @@ -526,21 +585,36 @@ func (db *DB) beginRWTx() (*Tx, error) { t := &Tx{writable: true} t.init(db) db.rwtx = t + db.freePages() + return t, nil +} - // Free any pages associated with closed read-only transactions. - var minid txid = 0xFFFFFFFFFFFFFFFF - for _, t := range db.txs { - if t.meta.txid < minid { - minid = t.meta.txid - } +// freePages releases any pages associated with closed read-only transactions. +func (db *DB) freePages() { + // Free all pending pages prior to earliest open transaction. + sort.Sort(txsById(db.txs)) + minid := txid(0xFFFFFFFFFFFFFFFF) + if len(db.txs) > 0 { + minid = db.txs[0].meta.txid } if minid > 0 { db.freelist.release(minid - 1) } - - return t, nil + // Release unused txid extents. + for _, t := range db.txs { + db.freelist.releaseRange(minid, t.meta.txid-1) + minid = t.meta.txid + 1 + } + db.freelist.releaseRange(minid, txid(0xFFFFFFFFFFFFFFFF)) + // Any page both allocated and freed in an extent is safe to release. } +type txsById []*Tx + +func (t txsById) Len() int { return len(t) } +func (t txsById) Swap(i, j int) { t[i], t[j] = t[j], t[i] } +func (t txsById) Less(i, j int) bool { return t[i].meta.txid < t[j].meta.txid } + // removeTx removes a transaction from the database. func (db *DB) removeTx(tx *Tx) { // Release the read lock on the mmap. @@ -633,11 +707,7 @@ func (db *DB) View(fn func(*Tx) error) error { return err } - if err := t.Rollback(); err != nil { - return err - } - - return nil + return t.Rollback() } // Batch calls fn as part of a batch. It behaves similar to Update, @@ -737,9 +807,7 @@ retry: // pass success, or bolt internal errors, to all callers for _, c := range b.calls { - if c.err != nil { - c.err <- err - } + c.err <- err } break retry } @@ -826,7 +894,7 @@ func (db *DB) meta() *meta { } // allocate returns a contiguous block of memory starting at a given page. -func (db *DB) allocate(count int) (*page, error) { +func (db *DB) allocate(txid txid, count int) (*page, error) { // Allocate a temporary buffer for the page. var buf []byte if count == 1 { @@ -838,7 +906,7 @@ func (db *DB) allocate(count int) (*page, error) { p.overflow = uint32(count - 1) // Use pages from the freelist if they are available. - if p.id = db.freelist.allocate(count); p.id != 0 { + if p.id = db.freelist.allocate(txid, count); p.id != 0 { return p, nil } @@ -893,6 +961,38 @@ func (db *DB) IsReadOnly() bool { return db.readOnly } +func (db *DB) freepages() []pgid { + tx, err := db.beginTx() + defer func() { + err = tx.Rollback() + if err != nil { + panic("freepages: failed to rollback tx") + } + }() + if err != nil { + panic("freepages: failed to open read only tx") + } + + reachable := make(map[pgid]*page) + nofreed := make(map[pgid]bool) + ech := make(chan error) + go func() { + for e := range ech { + panic(fmt.Sprintf("freepages: failed to get all reachable pages (%v)", e)) + } + }() + tx.checkBucket(&tx.root, reachable, nofreed, ech) + close(ech) + + var fids []pgid + for i := pgid(2); i < db.meta().pgid; i++ { + if _, ok := reachable[i]; !ok { + fids = append(fids, i) + } + } + return fids +} + // Options represents the options that can be set when opening a database. type Options struct { // Timeout is the amount of time to wait to obtain a file lock. @@ -903,6 +1003,10 @@ type Options struct { // Sets the DB.NoGrowSync flag before memory mapping the file. NoGrowSync bool + // Do not sync freelist to disk. This improves the database write performance + // under normal operation, but requires a full database re-sync during recovery. + NoFreelistSync bool + // Open database in read-only mode. Uses flock(..., LOCK_SH |LOCK_NB) to // grab a shared lock (UNIX). ReadOnly bool @@ -919,6 +1023,14 @@ type Options struct { // If initialMmapSize is smaller than the previous database size, // it takes no effect. InitialMmapSize int + + // PageSize overrides the default OS page size. + PageSize int + + // NoSync sets the initial value of DB.NoSync. Normally this can just be + // set directly on the DB itself when returned from Open(), but this option + // is useful in APIs which expose Options but not the underlying DB. + NoSync bool } // DefaultOptions represent the options used if nil options are passed into Open(). @@ -960,10 +1072,6 @@ func (s *Stats) Sub(other *Stats) Stats { return diff } -func (s *Stats) add(other *Stats) { - s.TxStats.add(&other.TxStats) -} - type Info struct { Data uintptr PageSize int @@ -1002,7 +1110,8 @@ func (m *meta) copy(dest *meta) { func (m *meta) write(p *page) { if m.root.root >= m.pgid { panic(fmt.Sprintf("root bucket pgid (%d) above high water mark (%d)", m.root.root, m.pgid)) - } else if m.freelist >= m.pgid { + } else if m.freelist >= m.pgid && m.freelist != pgidNoFreelist { + // TODO: reject pgidNoFreeList if !NoFreelistSync panic(fmt.Sprintf("freelist pgid (%d) above high water mark (%d)", m.freelist, m.pgid)) } @@ -1029,11 +1138,3 @@ func _assert(condition bool, msg string, v ...interface{}) { panic(fmt.Sprintf("assertion failed: "+msg, v...)) } } - -func warn(v ...interface{}) { fmt.Fprintln(os.Stderr, v...) } -func warnf(msg string, v ...interface{}) { fmt.Fprintf(os.Stderr, msg+"\n", v...) } - -func printstack() { - stack := strings.Join(strings.Split(string(debug.Stack()), "\n")[2:], "\n") - fmt.Fprintln(os.Stderr, stack) -} diff --git a/vendor/github.com/boltdb/bolt/doc.go b/vendor/github.com/coreos/bbolt/doc.go similarity index 100% rename from vendor/github.com/boltdb/bolt/doc.go rename to vendor/github.com/coreos/bbolt/doc.go diff --git a/vendor/github.com/boltdb/bolt/errors.go b/vendor/github.com/coreos/bbolt/errors.go similarity index 100% rename from vendor/github.com/boltdb/bolt/errors.go rename to vendor/github.com/coreos/bbolt/errors.go diff --git a/vendor/github.com/boltdb/bolt/freelist.go b/vendor/github.com/coreos/bbolt/freelist.go similarity index 65% rename from vendor/github.com/boltdb/bolt/freelist.go rename to vendor/github.com/coreos/bbolt/freelist.go index aba48f58c628..266f15429453 100644 --- a/vendor/github.com/boltdb/bolt/freelist.go +++ b/vendor/github.com/coreos/bbolt/freelist.go @@ -6,18 +6,28 @@ import ( "unsafe" ) +// txPending holds a list of pgids and corresponding allocation txns +// that are pending to be freed. +type txPending struct { + ids []pgid + alloctx []txid // txids allocating the ids + lastReleaseBegin txid // beginning txid of last matching releaseRange +} + // freelist represents a list of all pages that are available for allocation. // It also tracks pages that have been freed but are still in use by open transactions. type freelist struct { - ids []pgid // all free and available free page ids. - pending map[txid][]pgid // mapping of soon-to-be free page ids by tx. - cache map[pgid]bool // fast lookup of all free and pending page ids. + ids []pgid // all free and available free page ids. + allocs map[pgid]txid // mapping of txid that allocated a pgid. + pending map[txid]*txPending // mapping of soon-to-be free page ids by tx. + cache map[pgid]bool // fast lookup of all free and pending page ids. } // newFreelist returns an empty, initialized freelist. func newFreelist() *freelist { return &freelist{ - pending: make(map[txid][]pgid), + allocs: make(map[pgid]txid), + pending: make(map[txid]*txPending), cache: make(map[pgid]bool), } } @@ -45,8 +55,8 @@ func (f *freelist) free_count() int { // pending_count returns count of pending pages func (f *freelist) pending_count() int { var count int - for _, list := range f.pending { - count += len(list) + for _, txp := range f.pending { + count += len(txp.ids) } return count } @@ -55,8 +65,8 @@ func (f *freelist) pending_count() int { // f.count returns the minimum length required for dst. func (f *freelist) copyall(dst []pgid) { m := make(pgids, 0, f.pending_count()) - for _, list := range f.pending { - m = append(m, list...) + for _, txp := range f.pending { + m = append(m, txp.ids...) } sort.Sort(m) mergepgids(dst, f.ids, m) @@ -64,7 +74,7 @@ func (f *freelist) copyall(dst []pgid) { // allocate returns the starting page id of a contiguous list of pages of a given size. // If a contiguous block cannot be found then 0 is returned. -func (f *freelist) allocate(n int) pgid { +func (f *freelist) allocate(txid txid, n int) pgid { if len(f.ids) == 0 { return 0 } @@ -97,7 +107,7 @@ func (f *freelist) allocate(n int) pgid { for i := pgid(0); i < pgid(n); i++ { delete(f.cache, initial+i) } - + f.allocs[initial] = txid return initial } @@ -114,28 +124,73 @@ func (f *freelist) free(txid txid, p *page) { } // Free page and all its overflow pages. - var ids = f.pending[txid] + txp := f.pending[txid] + if txp == nil { + txp = &txPending{} + f.pending[txid] = txp + } + allocTxid, ok := f.allocs[p.id] + if ok { + delete(f.allocs, p.id) + } else if (p.flags & freelistPageFlag) != 0 { + // Freelist is always allocated by prior tx. + allocTxid = txid - 1 + } + for id := p.id; id <= p.id+pgid(p.overflow); id++ { // Verify that page is not already free. if f.cache[id] { panic(fmt.Sprintf("page %d already freed", id)) } - // Add to the freelist and cache. - ids = append(ids, id) + txp.ids = append(txp.ids, id) + txp.alloctx = append(txp.alloctx, allocTxid) f.cache[id] = true } - f.pending[txid] = ids } // release moves all page ids for a transaction id (or older) to the freelist. func (f *freelist) release(txid txid) { m := make(pgids, 0) - for tid, ids := range f.pending { + for tid, txp := range f.pending { if tid <= txid { // Move transaction's pending pages to the available freelist. // Don't remove from the cache since the page is still free. - m = append(m, ids...) + m = append(m, txp.ids...) + delete(f.pending, tid) + } + } + sort.Sort(m) + f.ids = pgids(f.ids).merge(m) +} + +// releaseRange moves pending pages allocated within an extent [begin,end] to the free list. +func (f *freelist) releaseRange(begin, end txid) { + if begin > end { + return + } + var m pgids + for tid, txp := range f.pending { + if tid < begin || tid > end { + continue + } + // Don't recompute freed pages if ranges haven't updated. + if txp.lastReleaseBegin == begin { + continue + } + for i := 0; i < len(txp.ids); i++ { + if atx := txp.alloctx[i]; atx < begin || atx > end { + continue + } + m = append(m, txp.ids[i]) + txp.ids[i] = txp.ids[len(txp.ids)-1] + txp.ids = txp.ids[:len(txp.ids)-1] + txp.alloctx[i] = txp.alloctx[len(txp.alloctx)-1] + txp.alloctx = txp.alloctx[:len(txp.alloctx)-1] + i-- + } + txp.lastReleaseBegin = begin + if len(txp.ids) == 0 { delete(f.pending, tid) } } @@ -146,12 +201,29 @@ func (f *freelist) release(txid txid) { // rollback removes the pages from a given pending tx. func (f *freelist) rollback(txid txid) { // Remove page ids from cache. - for _, id := range f.pending[txid] { - delete(f.cache, id) + txp := f.pending[txid] + if txp == nil { + return } - - // Remove pages from pending list. + var m pgids + for i, pgid := range txp.ids { + delete(f.cache, pgid) + tx := txp.alloctx[i] + if tx == 0 { + continue + } + if tx != txid { + // Pending free aborted; restore page back to alloc list. + f.allocs[pgid] = tx + } else { + // Freed page was allocated by this txn; OK to throw away. + m = append(m, pgid) + } + } + // Remove pages from pending list and mark as free if allocated by txid. delete(f.pending, txid) + sort.Sort(m) + f.ids = pgids(f.ids).merge(m) } // freed returns whether a given page is in the free list. @@ -161,6 +233,9 @@ func (f *freelist) freed(pgid pgid) bool { // read initializes the freelist from a freelist page. func (f *freelist) read(p *page) { + if (p.flags & freelistPageFlag) == 0 { + panic(fmt.Sprintf("invalid freelist page: %d, page type is %s", p.id, p.typ())) + } // If the page.count is at the max uint16 value (64k) then it's considered // an overflow and the size of the freelist is stored as the first element. idx, count := 0, int(p.count) @@ -173,7 +248,7 @@ func (f *freelist) read(p *page) { if count == 0 { f.ids = nil } else { - ids := ((*[maxAllocSize]pgid)(unsafe.Pointer(&p.ptr)))[idx:count] + ids := ((*[maxAllocSize]pgid)(unsafe.Pointer(&p.ptr)))[idx : idx+count] f.ids = make([]pgid, len(ids)) copy(f.ids, ids) @@ -185,6 +260,12 @@ func (f *freelist) read(p *page) { f.reindex() } +// read initializes the freelist from a given list of ids. +func (f *freelist) readIDs(ids []pgid) { + f.ids = ids + f.reindex() +} + // write writes the page ids onto a freelist page. All free and pending ids are // saved to disk since in the event of a program crash, all pending ids will // become free. @@ -217,8 +298,8 @@ func (f *freelist) reload(p *page) { // Build a cache of only pending pages. pcache := make(map[pgid]bool) - for _, pendingIDs := range f.pending { - for _, pendingID := range pendingIDs { + for _, txp := range f.pending { + for _, pendingID := range txp.ids { pcache[pendingID] = true } } @@ -244,8 +325,8 @@ func (f *freelist) reindex() { for _, id := range f.ids { f.cache[id] = true } - for _, pendingIDs := range f.pending { - for _, pendingID := range pendingIDs { + for _, txp := range f.pending { + for _, pendingID := range txp.ids { f.cache[pendingID] = true } } diff --git a/vendor/github.com/boltdb/bolt/node.go b/vendor/github.com/coreos/bbolt/node.go similarity index 99% rename from vendor/github.com/boltdb/bolt/node.go rename to vendor/github.com/coreos/bbolt/node.go index 159318b229cb..f4ce240edddb 100644 --- a/vendor/github.com/boltdb/bolt/node.go +++ b/vendor/github.com/coreos/bbolt/node.go @@ -365,7 +365,7 @@ func (n *node) spill() error { } // Allocate contiguous space for the node. - p, err := tx.allocate((node.size() / tx.db.pageSize) + 1) + p, err := tx.allocate((node.size() + tx.db.pageSize - 1) / tx.db.pageSize) if err != nil { return err } diff --git a/vendor/github.com/boltdb/bolt/page.go b/vendor/github.com/coreos/bbolt/page.go similarity index 100% rename from vendor/github.com/boltdb/bolt/page.go rename to vendor/github.com/coreos/bbolt/page.go diff --git a/vendor/github.com/boltdb/bolt/tx.go b/vendor/github.com/coreos/bbolt/tx.go similarity index 94% rename from vendor/github.com/boltdb/bolt/tx.go rename to vendor/github.com/coreos/bbolt/tx.go index 6700308a2903..41a9bc619ac7 100644 --- a/vendor/github.com/boltdb/bolt/tx.go +++ b/vendor/github.com/coreos/bbolt/tx.go @@ -126,10 +126,7 @@ func (tx *Tx) DeleteBucket(name []byte) error { // the error is returned to the caller. func (tx *Tx) ForEach(fn func(name []byte, b *Bucket) error) error { return tx.root.ForEach(func(k, v []byte) error { - if err := fn(k, tx.root.Bucket(k)); err != nil { - return err - } - return nil + return fn(k, tx.root.Bucket(k)) }) } @@ -169,28 +166,18 @@ func (tx *Tx) Commit() error { // Free the old root bucket. tx.meta.root.root = tx.root.root - opgid := tx.meta.pgid - - // Free the freelist and allocate new pages for it. This will overestimate - // the size of the freelist but not underestimate the size (which would be bad). - tx.db.freelist.free(tx.meta.txid, tx.db.page(tx.meta.freelist)) - p, err := tx.allocate((tx.db.freelist.size() / tx.db.pageSize) + 1) - if err != nil { - tx.rollback() - return err - } - if err := tx.db.freelist.write(p); err != nil { - tx.rollback() - return err + // Free the old freelist because commit writes out a fresh freelist. + if tx.meta.freelist != pgidNoFreelist { + tx.db.freelist.free(tx.meta.txid, tx.db.page(tx.meta.freelist)) } - tx.meta.freelist = p.id - // If the high water mark has moved up then attempt to grow the database. - if tx.meta.pgid > opgid { - if err := tx.db.grow(int(tx.meta.pgid+1) * tx.db.pageSize); err != nil { - tx.rollback() + if !tx.db.NoFreelistSync { + err := tx.commitFreelist() + if err != nil { return err } + } else { + tx.meta.freelist = pgidNoFreelist } // Write dirty pages to disk. @@ -235,6 +222,31 @@ func (tx *Tx) Commit() error { return nil } +func (tx *Tx) commitFreelist() error { + // Allocate new pages for the new free list. This will overestimate + // the size of the freelist but not underestimate the size (which would be bad). + opgid := tx.meta.pgid + p, err := tx.allocate((tx.db.freelist.size() / tx.db.pageSize) + 1) + if err != nil { + tx.rollback() + return err + } + if err := tx.db.freelist.write(p); err != nil { + tx.rollback() + return err + } + tx.meta.freelist = p.id + // If the high water mark has moved up then attempt to grow the database. + if tx.meta.pgid > opgid { + if err := tx.db.grow(int(tx.meta.pgid+1) * tx.db.pageSize); err != nil { + tx.rollback() + return err + } + } + + return nil +} + // Rollback closes the transaction and ignores all previous updates. Read-only // transactions must be rolled back and not committed. func (tx *Tx) Rollback() error { @@ -291,7 +303,9 @@ func (tx *Tx) close() { } // Copy writes the entire database to a writer. -// This function exists for backwards compatibility. Use WriteTo() instead. +// This function exists for backwards compatibility. +// +// Deprecated; Use WriteTo() instead. func (tx *Tx) Copy(w io.Writer) error { _, err := tx.WriteTo(w) return err @@ -305,7 +319,11 @@ func (tx *Tx) WriteTo(w io.Writer) (n int64, err error) { if err != nil { return 0, err } - defer func() { _ = f.Close() }() + defer func() { + if cerr := f.Close(); err == nil { + err = cerr + } + }() // Generate a meta page. We use the same page data for both meta pages. buf := make([]byte, tx.db.pageSize) @@ -333,7 +351,7 @@ func (tx *Tx) WriteTo(w io.Writer) (n int64, err error) { } // Move past the meta pages in the file. - if _, err := f.Seek(int64(tx.db.pageSize*2), os.SEEK_SET); err != nil { + if _, err := f.Seek(int64(tx.db.pageSize*2), io.SeekStart); err != nil { return n, fmt.Errorf("seek: %s", err) } @@ -344,7 +362,7 @@ func (tx *Tx) WriteTo(w io.Writer) (n int64, err error) { return n, err } - return n, f.Close() + return n, nil } // CopyFile copies the entire database to file at the given path. @@ -379,6 +397,9 @@ func (tx *Tx) Check() <-chan error { } func (tx *Tx) check(ch chan error) { + // Force loading free list if opened in ReadOnly mode. + tx.db.loadFreelist() + // Check if any pages are double freed. freed := make(map[pgid]bool) all := make([]pgid, tx.db.freelist.count()) @@ -394,8 +415,10 @@ func (tx *Tx) check(ch chan error) { reachable := make(map[pgid]*page) reachable[0] = tx.page(0) // meta0 reachable[1] = tx.page(1) // meta1 - for i := uint32(0); i <= tx.page(tx.meta.freelist).overflow; i++ { - reachable[tx.meta.freelist+pgid(i)] = tx.page(tx.meta.freelist) + if tx.meta.freelist != pgidNoFreelist { + for i := uint32(0); i <= tx.page(tx.meta.freelist).overflow; i++ { + reachable[tx.meta.freelist+pgid(i)] = tx.page(tx.meta.freelist) + } } // Recursively check buckets. @@ -453,7 +476,7 @@ func (tx *Tx) checkBucket(b *Bucket, reachable map[pgid]*page, freed map[pgid]bo // allocate returns a contiguous block of memory starting at a given page. func (tx *Tx) allocate(count int) (*page, error) { - p, err := tx.db.allocate(count) + p, err := tx.db.allocate(tx.meta.txid, count) if err != nil { return nil, err } @@ -462,7 +485,7 @@ func (tx *Tx) allocate(count int) (*page, error) { tx.pages[p.id] = p // Update statistics. - tx.stats.PageCount++ + tx.stats.PageCount += count tx.stats.PageAlloc += count * tx.db.pageSize return p, nil diff --git a/vendor/vendor.json b/vendor/vendor.json index 476482e1f168..07c356ac4434 100644 --- a/vendor/vendor.json +++ b/vendor/vendor.json @@ -116,12 +116,10 @@ "revisionTime": "2016-09-02T18:42:37Z" }, { - "checksumSHA1": "R1Q34Pfnt197F/nCOO9kG8c+Z90=", - "path": "github.com/boltdb/bolt", - "revision": "2f1ce7a837dcb8da3ec595b1dac9d0632f0f99e8", - "revisionTime": "2017-07-17T17:11:48Z", - "version": "v1.3.1", - "versionExact": "v1.3.1" + "checksumSHA1": "qFaKrhSla38BRAyaGz2UaZvH/Dk=", + "path": "github.com/coreos/bbolt", + "revision": "af9db2027c98c61ecd8e17caa5bd265792b9b9a2", + "revisionTime": "2018-03-18T00:15:26Z" }, { "checksumSHA1": "dvabztWVQX8f6oMLRyv4dLH+TGY=", From 540674572fbb5bf96021c5043412d5106c8f0df4 Mon Sep 17 00:00:00 2001 From: Andrew Kroh Date: Tue, 24 Jul 2018 02:05:07 -0400 Subject: [PATCH 31/34] Generate fields.yml using Mage (#7670) Make will now delegate to mage for generating fields.yml. Make will check if the mage command exists and go install it if not. The FIELDS_FILE_PATH make variable is not longer used because the path(s) are specified in magefile.go. This allows fields.yml to be generated on Windows using Mage. The CI scripts for Windows have been updated so that fields.yml is generated for all Beats during testing. This also adds a make.bat in each directory where building occurs to give Windows users a starting point. Some fixes were made to the generators because: - rsync was excluding important source files contained in a directory named "build" - the generated project needed to be `git init` before running certain magefile targets that detect project's root dir and import path. --- CHANGELOG-developer.asciidoc | 4 ++ auditbeat/Makefile | 1 - auditbeat/magefile.go | 5 ++ auditbeat/make.bat | 11 +++++ dev-tools/jenkins_ci.ps1 | 23 +++++---- dev-tools/mage/fields.go | 48 +++++++++++++++++++ .../templates/common/magefile.go.tmpl | 5 ++ filebeat/magefile.go | 5 ++ filebeat/make.bat | 18 ++++--- generator/beat/Makefile | 3 -- generator/beat/{beat}/Makefile | 18 +++---- generator/beat/{beat}/magefile.go | 5 ++ generator/beat/{beat}/make.bat | 11 +++++ generator/common/Makefile | 19 ++++++-- generator/metricbeat/Makefile | 10 ++-- generator/metricbeat/{beat}/Makefile | 9 ++-- generator/metricbeat/{beat}/magefile.go | 5 ++ generator/metricbeat/{beat}/make.bat | 11 +++++ heartbeat/Makefile | 1 - heartbeat/magefile.go | 5 ++ heartbeat/make.bat | 11 +++++ libbeat/Makefile | 1 - libbeat/generator/fields/fields.go | 14 ++++-- libbeat/magefile.go | 39 +++++++++++++++ libbeat/make.bat | 11 +++++ libbeat/scripts/Makefile | 11 +++-- libbeat/scripts/cmd/global_fields/main.go | 37 +++++++------- make.bat | 11 +++++ metricbeat/Makefile | 1 - metricbeat/magefile.go | 5 ++ metricbeat/make.bat | 35 +++----------- packetbeat/Makefile | 1 - packetbeat/magefile.go | 5 ++ packetbeat/make.bat | 11 +++++ winlogbeat/magefile.go | 5 ++ winlogbeat/make.bat | 35 +++----------- 36 files changed, 317 insertions(+), 133 deletions(-) create mode 100644 auditbeat/make.bat create mode 100644 dev-tools/mage/fields.go create mode 100644 generator/beat/{beat}/make.bat create mode 100644 generator/metricbeat/{beat}/make.bat create mode 100644 heartbeat/make.bat create mode 100644 libbeat/magefile.go create mode 100644 libbeat/make.bat create mode 100644 make.bat create mode 100644 packetbeat/make.bat diff --git a/CHANGELOG-developer.asciidoc b/CHANGELOG-developer.asciidoc index b47c53ca28a3..cf844df59cfa 100644 --- a/CHANGELOG-developer.asciidoc +++ b/CHANGELOG-developer.asciidoc @@ -25,6 +25,10 @@ The list below covers the major changes between 6.3.0 and master only. - Dashboards under _meta/kibana are expected to be decoded. See https://github.com/elastic/beats/pull/7224 for a conversion script. {pull}7265[7265] - Constructor `(github.com/elastic/beats/libbeat/output/codec/json).New` expects a new `escapeHTML` parameter. {pull}7445[7445] - Packaging has been refactored and updates are required. See the PR for migration details. {pull}7388[7388] +- `make fields` has been modified to use Mage (https://magefile.org/) in an effort to make + the building a Beat more cross-platform friendly (e.g. Windows). This requires that your Beat + has a magefile.go with a fields target. The `FIELDS_FILE_PATH` make variable is no longer + used because the value is specified in magefile.go. {pull}7670[7670] ==== Bugfixes diff --git a/auditbeat/Makefile b/auditbeat/Makefile index 36c51fbf0e62..08c0d4be4b74 100644 --- a/auditbeat/Makefile +++ b/auditbeat/Makefile @@ -6,7 +6,6 @@ GOX_OS?=linux windows ## @Building List of all OS to be supported by "make cross DEV_OS?=linux TESTING_ENVIRONMENT?=snapshot-noxpack ES_BEATS?=.. -FIELDS_FILE_PATH=module # Path to the libbeat Makefile include ${ES_BEATS}/libbeat/scripts/Makefile diff --git a/auditbeat/magefile.go b/auditbeat/magefile.go index 234afa2449fc..0b45a4e52c6f 100644 --- a/auditbeat/magefile.go +++ b/auditbeat/magefile.go @@ -91,6 +91,11 @@ func Update() error { return sh.Run("make", "update") } +// Fields generates a fields.yml for the Beat. +func Fields() error { + return mage.GenerateFieldsYAML("module") +} + // ----------------------------------------------------------------------------- // Customizations specific to Auditbeat. // - Config files are Go templates. diff --git a/auditbeat/make.bat b/auditbeat/make.bat new file mode 100644 index 000000000000..81de1ba946f9 --- /dev/null +++ b/auditbeat/make.bat @@ -0,0 +1,11 @@ +@echo off + +REM Windows wrapper for Mage (https://magefile.org/) that installs it +REM to %GOPATH%\bin from the Beats vendor directory. +REM +REM After running this once you may invoke mage.exe directly. + +WHERE mage +IF %ERRORLEVEL% NEQ 0 go install github.com/elastic/beats/vendor/github.com/magefile/mage + +mage %* diff --git a/dev-tools/jenkins_ci.ps1 b/dev-tools/jenkins_ci.ps1 index a27381a36e99..39abe9fad178 100755 --- a/dev-tools/jenkins_ci.ps1 +++ b/dev-tools/jenkins_ci.ps1 @@ -21,6 +21,14 @@ $env:PATH = "$env:GOPATH\bin;C:\tools\mingw64\bin;$env:PATH" # each run starts from a clean slate. $env:MAGEFILE_CACHE = "$env:WORKSPACE\.magefile" +exec { go install github.com/elastic/beats/vendor/github.com/magefile/mage } +exec { go get -u github.com/jstemmer/go-junit-report } + +echo "Building libbeat fields.yml" +cd libbeat +exec { mage fields } +cd .. + if (Test-Path "$env:beat") { cd "$env:beat" } else { @@ -35,20 +43,11 @@ New-Item -ItemType directory -Path build\coverage | Out-Null New-Item -ItemType directory -Path build\system-tests | Out-Null New-Item -ItemType directory -Path build\system-tests\run | Out-Null -exec { go get -u github.com/jstemmer/go-junit-report } +echo "Building fields.yml" +exec { mage fields } echo "Building $env:beat" -exec { go build } "Build FAILURE" - -# always build the libbeat fields -cp ..\libbeat\_meta\fields.common.yml ..\libbeat\_meta\fields.generated.yml -cat ..\libbeat\processors\*\_meta\fields.yml | Out-File -append -encoding UTF8 -filepath ..\libbeat\_meta\fields.generated.yml -cp ..\libbeat\_meta\fields.generated.yml ..\libbeat\fields.yml - -if ($env:beat -eq "metricbeat") { - cp .\_meta\fields.common.yml .\_meta\fields.generated.yml - python .\scripts\fields_collector.py | out-file -append -encoding UTF8 -filepath .\_meta\fields.generated.yml -} +exec { mage build } "Build FAILURE" echo "Unit testing $env:beat" go test -v $(go list ./... | select-string -Pattern "vendor" -NotMatch) 2>&1 | Out-File -encoding UTF8 build/TEST-go-unit.out diff --git a/dev-tools/mage/fields.go b/dev-tools/mage/fields.go new file mode 100644 index 000000000000..8f658483ffbe --- /dev/null +++ b/dev-tools/mage/fields.go @@ -0,0 +1,48 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +package mage + +import ( + "path/filepath" + + "github.com/magefile/mage/sh" +) + +// GenerateFieldsYAML generates a fields.yml file for a Beat. This will include +// the common fields specified by libbeat, the common fields for the Beat, +// and any additional fields.yml files you specify. +// +// fieldsFiles specifies additional directories to search recursively for files +// named fields.yml. The contents of each fields.yml will be included in the +// generated file. +func GenerateFieldsYAML(fieldsFiles ...string) error { + const globalFieldsCmdPath = "libbeat/scripts/cmd/global_fields/main.go" + + beatsDir, err := ElasticBeatsDir() + if err != nil { + return err + } + + globalFieldsCmd := sh.RunCmd("go", "run", + filepath.Join(beatsDir, globalFieldsCmdPath), + "-es_beats_path", beatsDir, + "-beat_path", CWD(), + ) + + return globalFieldsCmd(fieldsFiles...) +} diff --git a/dev-tools/packaging/templates/common/magefile.go.tmpl b/dev-tools/packaging/templates/common/magefile.go.tmpl index 1a9822d2491c..db7f7132110f 100644 --- a/dev-tools/packaging/templates/common/magefile.go.tmpl +++ b/dev-tools/packaging/templates/common/magefile.go.tmpl @@ -70,3 +70,8 @@ func TestPackages() error { func Update() error { return sh.Run("make", "update") } + +// Fields generates a fields.yml for the Beat. +func Fields() error { + return mage.GenerateFieldsYAML("protos") +} diff --git a/filebeat/magefile.go b/filebeat/magefile.go index 8feb27a69085..41cb9ce90143 100644 --- a/filebeat/magefile.go +++ b/filebeat/magefile.go @@ -91,6 +91,11 @@ func Update() error { return sh.Run("make", "update") } +// Fields generates a fields.yml for the Beat. +func Fields() error { + return mage.GenerateFieldsYAML("module") +} + // ----------------------------------------------------------------------------- // Customizations specific to Filebeat. // - Include modules directory in packages (minus _meta and test files). diff --git a/filebeat/make.bat b/filebeat/make.bat index 3f92e367f42e..81de1ba946f9 100644 --- a/filebeat/make.bat +++ b/filebeat/make.bat @@ -1,7 +1,11 @@ -REM Batch script to build and test on Windows. You can use this in conjunction -REM with the Vagrant machine. -go build -go test ./... -go test -c -cover -covermode=count -coverpkg ./... -cd tests\system -nosetests +@echo off + +REM Windows wrapper for Mage (https://magefile.org/) that installs it +REM to %GOPATH%\bin from the Beats vendor directory. +REM +REM After running this once you may invoke mage.exe directly. + +WHERE mage +IF %ERRORLEVEL% NEQ 0 go install github.com/elastic/beats/vendor/github.com/magefile/mage + +mage %* diff --git a/generator/beat/Makefile b/generator/beat/Makefile index 0e5913ea44dc..dd1e5be85573 100644 --- a/generator/beat/Makefile +++ b/generator/beat/Makefile @@ -1,4 +1 @@ -override FIELDS_FILE_PATH= -export FIELDS_FILE_PATH - include ../common/Makefile diff --git a/generator/beat/{beat}/Makefile b/generator/beat/{beat}/Makefile index e96c81728f1b..8fdde0a7e0c8 100644 --- a/generator/beat/{beat}/Makefile +++ b/generator/beat/{beat}/Makefile @@ -13,7 +13,7 @@ MAGE_IMPORT_PATH=${BEAT_PATH}/vendor/github.com/magefile/mage # Initial beat setup .PHONY: setup -setup: copy-vendor update git-init +setup: copy-vendor git-init update git-add # Copy beats into vendor directory .PHONY: copy-vendor @@ -27,17 +27,11 @@ copy-vendor: .PHONY: git-init git-init: git init - git add README.md CONTRIBUTING.md - git commit -m "Initial commit" - git add LICENSE.txt - git commit -m "Add the LICENSE" - git add .gitignore - git commit -m "Add git settings" - git add . - git reset -- .travis.yml - git commit -m "Add {beat}" - git add .travis.yml - git commit -m "Add Travis CI" + +.PHONY: git-add +git-add: + git add -A + git commit -m "Add generated {beat} files" # Collects all dependencies and then calls update .PHONY: collect diff --git a/generator/beat/{beat}/magefile.go b/generator/beat/{beat}/magefile.go index 545af4c3d106..13c6184b5fa7 100644 --- a/generator/beat/{beat}/magefile.go +++ b/generator/beat/{beat}/magefile.go @@ -89,3 +89,8 @@ func TestPackages() error { func Update() error { return sh.Run("make", "update") } + +// Fields generates a fields.yml for the Beat. +func Fields() error { + return mage.GenerateFieldsYAML() +} diff --git a/generator/beat/{beat}/make.bat b/generator/beat/{beat}/make.bat new file mode 100644 index 000000000000..72de5798dfa5 --- /dev/null +++ b/generator/beat/{beat}/make.bat @@ -0,0 +1,11 @@ +@echo off + +REM Windows wrapper for Mage (https://magefile.org/) that installs it +REM to %GOPATH%\bin from the Beats vendor directory. +REM +REM After running this once you may invoke mage.exe directly. + +WHERE mage +IF %ERRORLEVEL% NEQ 0 go install {beat_path}/vendor/github.com/magefile/mage + +mage %* diff --git a/generator/common/Makefile b/generator/common/Makefile index 248b6c7119c2..8ad037be6e08 100644 --- a/generator/common/Makefile +++ b/generator/common/Makefile @@ -11,23 +11,36 @@ PREPARE_COMMAND?= test: prepare-test . ${PYTHON_ENV}/bin/activate; \ export GOPATH=${PWD}/build ; \ - export PATH=${PATH}:${PWD}/build/bin; \ + export PATH=$${GOPATH}/bin:${PATH}; \ cd ${BEAT_PATH} ; \ $(MAKE) copy-vendor || exit 1 ; \ ${PREPARE_COMMAND} \ + $(MAKE) git-init || exit 1 ; \ $(MAKE) update || exit 1 ; \ + $(MAKE) git-add || exit 1 ; \ $(MAKE) check CHECK_HEADERS_DISABLED=y || exit 1 ; \ $(MAKE) || exit 1 ; \ $(MAKE) unit +.PHONY: prepare-test prepare-test:: python-env # Makes sure to use current version of beats for testing mkdir -p ${BUILD_DIR}/src/github.com/elastic/beats/ - rsync -a --exclude=build ${PWD}/../../* ${BUILD_DIR}/src/github.com/elastic/beats/ + rsync -a \ + --include=vendor/github.com/magefile/mage/build \ + --exclude=build/ \ + --exclude=.git/ \ + ${PWD}/../../* ${BUILD_DIR}/src/github.com/elastic/beats/ mkdir -p ${BEAT_PATH} export GOPATH=${PWD}/build ; \ - . ${PYTHON_ENV}/bin/activate && python ${PWD}/build/src/github.com/elastic/beats/script/generate.py --type=${BEAT_TYPE} --project_name=Testbeat --github_name=ruflin --beat_path=beatpath/testbeat --full_name="Nicolas Ruflin" + . ${PYTHON_ENV}/bin/activate && \ + python ${PWD}/build/src/github.com/elastic/beats/script/generate.py \ + --type=${BEAT_TYPE} \ + --project_name=Testbeat \ + --github_name=ruflin \ + --beat_path=beatpath/testbeat \ + --full_name="Nicolas Ruflin" # Runs test build for the created beat .PHONY: test-build diff --git a/generator/metricbeat/Makefile b/generator/metricbeat/Makefile index 11203d15e0fe..f91acb876a32 100644 --- a/generator/metricbeat/Makefile +++ b/generator/metricbeat/Makefile @@ -1,16 +1,14 @@ -BEAT_TYPE=metricbeat -PREPARE_COMMAND=MODULE=elastic METRICSET=test make create-metricset ; FIELDS_FILE_PATH=module -override FIELDS_FILE_PATH= -export FIELDS_FILE_PATH - +BEAT_TYPE = metricbeat +PREPARE_COMMAND = MODULE=elastic METRICSET=test make create-metricset; include ../common/Makefile +.PHONY: prepare-test prepare-test:: python-env - mkdir -p ${BEAT_PATH}/scripts rsync -a --exclude=build ${PWD}/../../metricbeat/scripts/generate_imports_helper.py ${BEAT_PATH}/scripts # Collects all dependencies and then calls update .PHONY: collect collect: fields + diff --git a/generator/metricbeat/{beat}/Makefile b/generator/metricbeat/{beat}/Makefile index 9882c9783f0c..478a3f7a4e17 100644 --- a/generator/metricbeat/{beat}/Makefile +++ b/generator/metricbeat/{beat}/Makefile @@ -13,7 +13,7 @@ MAGE_IMPORT_PATH=${BEAT_PATH}/vendor/github.com/magefile/mage # Initial beat setup .PHONY: setup -setup: copy-vendor create-metricset collect git-init +setup: copy-vendor git-init create-metricset collect git-add # Copy beats into vendor directory .PHONY: copy-vendor @@ -28,5 +28,8 @@ copy-vendor: .PHONY: git-init git-init: git init - git add --all - git commit -m 'Initial add by Beat generator' + +.PHONY: git-add +git-add: + git add -A + git commit -m "Add generated {beat} files" diff --git a/generator/metricbeat/{beat}/magefile.go b/generator/metricbeat/{beat}/magefile.go index 545af4c3d106..fa75eff3a806 100644 --- a/generator/metricbeat/{beat}/magefile.go +++ b/generator/metricbeat/{beat}/magefile.go @@ -89,3 +89,8 @@ func TestPackages() error { func Update() error { return sh.Run("make", "update") } + +// Fields generates a fields.yml for the Beat. +func Fields() error { + return mage.GenerateFieldsYAML("module") +} diff --git a/generator/metricbeat/{beat}/make.bat b/generator/metricbeat/{beat}/make.bat new file mode 100644 index 000000000000..72de5798dfa5 --- /dev/null +++ b/generator/metricbeat/{beat}/make.bat @@ -0,0 +1,11 @@ +@echo off + +REM Windows wrapper for Mage (https://magefile.org/) that installs it +REM to %GOPATH%\bin from the Beats vendor directory. +REM +REM After running this once you may invoke mage.exe directly. + +WHERE mage +IF %ERRORLEVEL% NEQ 0 go install {beat_path}/vendor/github.com/magefile/mage + +mage %* diff --git a/heartbeat/Makefile b/heartbeat/Makefile index 16053181ce5f..498c10747b57 100644 --- a/heartbeat/Makefile +++ b/heartbeat/Makefile @@ -2,7 +2,6 @@ BEAT_NAME=heartbeat BEAT_TITLE=Heartbeat SYSTEM_TESTS=true TEST_ENVIRONMENT=false -FIELDS_FILE_PATH=monitors/active # Path to the libbeat Makefile -include ../libbeat/scripts/Makefile diff --git a/heartbeat/magefile.go b/heartbeat/magefile.go index f52d0935da9d..a23b8687e00a 100644 --- a/heartbeat/magefile.go +++ b/heartbeat/magefile.go @@ -88,3 +88,8 @@ func TestPackages() error { func Update() error { return sh.Run("make", "update") } + +// Fields generates a fields.yml for the Beat. +func Fields() error { + return mage.GenerateFieldsYAML("monitors/active") +} diff --git a/heartbeat/make.bat b/heartbeat/make.bat new file mode 100644 index 000000000000..81de1ba946f9 --- /dev/null +++ b/heartbeat/make.bat @@ -0,0 +1,11 @@ +@echo off + +REM Windows wrapper for Mage (https://magefile.org/) that installs it +REM to %GOPATH%\bin from the Beats vendor directory. +REM +REM After running this once you may invoke mage.exe directly. + +WHERE mage +IF %ERRORLEVEL% NEQ 0 go install github.com/elastic/beats/vendor/github.com/magefile/mage + +mage %* diff --git a/libbeat/Makefile b/libbeat/Makefile index d63820feabc7..93b34f771049 100644 --- a/libbeat/Makefile +++ b/libbeat/Makefile @@ -1,7 +1,6 @@ BEAT_NAME=libbeat TEST_ENVIRONMENT?=true SYSTEM_TESTS=true -FIELDS_FILE_PATH=processors include scripts/Makefile diff --git a/libbeat/generator/fields/fields.go b/libbeat/generator/fields/fields.go index 68365dced93a..02ec53749487 100644 --- a/libbeat/generator/fields/fields.go +++ b/libbeat/generator/fields/fields.go @@ -20,12 +20,13 @@ package fields import ( "bufio" "bytes" - "fmt" "io/ioutil" "os" "path" "path/filepath" "strings" + + "github.com/pkg/errors" ) var ( @@ -152,7 +153,7 @@ func createIfNotExists(inPath, outPath string) error { if os.IsNotExist(err) { err := copyFileWithFlag(inPath, outPath, os.O_RDWR|os.O_CREATE|os.O_TRUNC) if err != nil { - fmt.Println("Cannot find _meta/fields.yml") + return err } return nil } @@ -162,12 +163,17 @@ func createIfNotExists(inPath, outPath string) error { func copyFileWithFlag(in, out string, flag int) error { input, err := ioutil.ReadFile(in) if err != nil { - return err + return errors.Wrap(err, "failed to read source in copy") + } + + if err := os.MkdirAll(filepath.Dir(out), 0755); err != nil { + return errors.Wrapf(err, "failed to create destination dir for copy "+ + "at %v", filepath.Dir(out)) } output, err := os.OpenFile(out, flag, 0644) if err != nil { - return err + return errors.Wrap(err, "failed to open destination file for copy") } defer output.Close() diff --git a/libbeat/magefile.go b/libbeat/magefile.go new file mode 100644 index 000000000000..939eac4adb02 --- /dev/null +++ b/libbeat/magefile.go @@ -0,0 +1,39 @@ +// Licensed to Elasticsearch B.V. under one or more contributor +// license agreements. See the NOTICE file distributed with +// this work for additional information regarding copyright +// ownership. Elasticsearch B.V. licenses this file to you under +// the Apache License, Version 2.0 (the "License"); you may +// not use this file except in compliance with the License. +// You may obtain a copy of the License at +// +// http://www.apache.org/licenses/LICENSE-2.0 +// +// Unless required by applicable law or agreed to in writing, +// software distributed under the License is distributed on an +// "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +// KIND, either express or implied. See the License for the +// specific language governing permissions and limitations +// under the License. + +// +build mage + +package main + +import ( + "github.com/elastic/beats/dev-tools/mage" +) + +// Build builds the Beat binary. +func Build() error { + return mage.Build(mage.DefaultBuildArgs()) +} + +// Clean cleans all generated files and build artifacts. +func Clean() error { + return mage.Clean() +} + +// Fields generates a fields.yml for the Beat. +func Fields() error { + return mage.GenerateFieldsYAML("processors") +} diff --git a/libbeat/make.bat b/libbeat/make.bat new file mode 100644 index 000000000000..81de1ba946f9 --- /dev/null +++ b/libbeat/make.bat @@ -0,0 +1,11 @@ +@echo off + +REM Windows wrapper for Mage (https://magefile.org/) that installs it +REM to %GOPATH%\bin from the Beats vendor directory. +REM +REM After running this once you may invoke mage.exe directly. + +WHERE mage +IF %ERRORLEVEL% NEQ 0 go install github.com/elastic/beats/vendor/github.com/magefile/mage + +mage %* diff --git a/libbeat/scripts/Makefile b/libbeat/scripts/Makefile index d2b109cbcbb3..8e8a0ac38874 100755 --- a/libbeat/scripts/Makefile +++ b/libbeat/scripts/Makefile @@ -20,7 +20,9 @@ ELASTIC_LICENSE_FILE?=../licenses/ELASTIC-LICENSE.txt SECCOMP_BINARY?=${BEAT_NAME} SECCOMP_BLACKLIST?=${ES_BEATS}/libbeat/common/seccomp/seccomp-profiler-blacklist.txt SECCOMP_ALLOWLIST?=${ES_BEATS}/libbeat/common/seccomp/seccomp-profiler-allow.txt +MAGE_PRESENT := $(shell command -v mage 2> /dev/null) MAGE_IMPORT_PATH?=github.com/elastic/beats/vendor/github.com/magefile/mage +export MAGE_IMPORT_PATH space:=$() # comma:=, @@ -304,9 +306,8 @@ coverage-report: .PHONY: fields -fields: - @go run ${ES_BEATS}/libbeat/scripts/cmd/global_fields/main.go --es_beats_path $(ES_BEATS) --beat_path $(PWD) $(FIELDS_FILE_PATH) - +fields: mage + mage -v fields .PHONY: libbeat_fields libbeat_fields: @@ -442,7 +443,9 @@ seccomp-package: .PHONY: mage mage: - @go install ${MAGE_IMPORT_PATH} +ifndef MAGE_PRESENT + go install ${MAGE_IMPORT_PATH} +endif .PHONY: release release: mage diff --git a/libbeat/scripts/cmd/global_fields/main.go b/libbeat/scripts/cmd/global_fields/main.go index 8bd5b6915061..74fc94a603d2 100644 --- a/libbeat/scripts/cmd/global_fields/main.go +++ b/libbeat/scripts/cmd/global_fields/main.go @@ -31,41 +31,46 @@ func main() { beatPath := flag.String("beat_path", ".", "Path to your Beat") flag.Parse() - beatFieldsPath := flag.Args() + beatFieldsPaths := flag.Args() name := filepath.Base(*beatPath) - err := os.MkdirAll(filepath.Join(*beatPath, "_meta"), 0744) + if *beatPath == "" { + fmt.Fprintf(os.Stderr, "beat_path cannot be empty") + os.Exit(1) + } + + err := os.MkdirAll(filepath.Join(*beatPath, "_meta"), 0755) if err != nil { - fmt.Printf("Cannot create _meta dir for %s: %v\n", name, err) + fmt.Fprintf(os.Stderr, "Cannot create _meta dir for %s: %+v\n", name, err) os.Exit(1) } - if len(beatFieldsPath) == 0 { + if len(beatFieldsPaths) == 0 { fmt.Println("No field files to collect") err = fields.AppendFromLibbeat(*esBeatsPath, *beatPath) if err != nil { - fmt.Printf("Cannot generate global fields.yml for %s: %v\n", name, err) + fmt.Fprintf(os.Stderr, "Cannot generate global fields.yml for %s: %+v\n", name, err) os.Exit(2) } return } - if *beatPath == "" { - fmt.Println("beat_path cannot be empty") - os.Exit(1) - } + var fieldsFiles []*fields.YmlFile + for _, fieldsFilePath := range beatFieldsPaths { + pathToModules := filepath.Join(*beatPath, fieldsFilePath) - pathToModules := filepath.Join(*beatPath, beatFieldsPath[0]) - fieldFiles, err := fields.CollectModuleFiles(pathToModules) - if err != nil { - fmt.Printf("Cannot collect fields.yml files: %v\n", err) - os.Exit(2) + fieldsFile, err := fields.CollectModuleFiles(pathToModules) + if err != nil { + fmt.Fprintf(os.Stderr, "Cannot collect fields.yml files: %+v\n", err) + os.Exit(2) + } + fieldsFiles = append(fieldsFiles, fieldsFile...) } - err = fields.Generate(*esBeatsPath, *beatPath, fieldFiles) + err = fields.Generate(*esBeatsPath, *beatPath, fieldsFiles) if err != nil { - fmt.Printf("Cannot generate global fields.yml file for %s: %v\n", name, err) + fmt.Fprintf(os.Stderr, "Cannot generate global fields.yml file for %s: %+v\n", name, err) os.Exit(3) } diff --git a/make.bat b/make.bat new file mode 100644 index 000000000000..81de1ba946f9 --- /dev/null +++ b/make.bat @@ -0,0 +1,11 @@ +@echo off + +REM Windows wrapper for Mage (https://magefile.org/) that installs it +REM to %GOPATH%\bin from the Beats vendor directory. +REM +REM After running this once you may invoke mage.exe directly. + +WHERE mage +IF %ERRORLEVEL% NEQ 0 go install github.com/elastic/beats/vendor/github.com/magefile/mage + +mage %* diff --git a/metricbeat/Makefile b/metricbeat/Makefile index a055c1a6f043..f42f8cca6f4f 100644 --- a/metricbeat/Makefile +++ b/metricbeat/Makefile @@ -4,7 +4,6 @@ BEAT_TITLE?=Metricbeat SYSTEM_TESTS?=true TEST_ENVIRONMENT?=true ES_BEATS?=.. -FIELDS_FILE_PATH?=module # Metricbeat can only be cross-compiled on platforms not requiring CGO. GOX_OS=netbsd linux windows diff --git a/metricbeat/magefile.go b/metricbeat/magefile.go index 02f9bbe516ce..c19cbf578a9a 100644 --- a/metricbeat/magefile.go +++ b/metricbeat/magefile.go @@ -91,6 +91,11 @@ func Update() error { return sh.Run("make", "update") } +// Fields generates a fields.yml for the Beat. +func Fields() error { + return mage.GenerateFieldsYAML("module") +} + // ----------------------------------------------------------------------------- // Customizations specific to Metricbeat. // - Include modules.d directory in packages. diff --git a/metricbeat/make.bat b/metricbeat/make.bat index 7edecf7aacaf..81de1ba946f9 100644 --- a/metricbeat/make.bat +++ b/metricbeat/make.bat @@ -1,34 +1,11 @@ @echo off +REM Windows wrapper for Mage (https://magefile.org/) that installs it +REM to %GOPATH%\bin from the Beats vendor directory. REM -REM Batch script to build and test on Windows. You can use this in conjunction -REM with the Vagrant machine. -REM - -go install github.com/elastic/beats/vendor/github.com/pierrre/gotestcover -if %errorlevel% neq 0 exit /b %errorlevel% - -echo Building -go build -if %errorlevel% neq 0 exit /b %errorlevel% - -echo Testing -mkdir build\coverage -gotestcover -race -coverprofile=build/coverage/integration.cov github.com/elastic/beats/metricbeat/... -if %errorlevel% neq 0 exit /b %errorlevel% - -echo System Testing -go test -c -covermode=atomic -coverpkg ./... -if %errorlevel% neq 0 exit /b %errorlevel% -nosetests -v -w tests\system --process-timeout=30 -if %errorlevel% neq 0 exit /b %errorlevel% +REM After running this once you may invoke mage.exe directly. -echo Aggregating Coverage Reports -python ..\dev-tools\aggregate_coverage.py -o build\coverage\system.cov .\build\system-tests\run -if %errorlevel% neq 0 exit /b %errorlevel% -python ..\dev-tools\aggregate_coverage.py -o build\coverage\full.cov .\build\coverage -if %errorlevel% neq 0 exit /b %errorlevel% -go tool cover -html=build\coverage\full.cov -o build\coverage\full.html -if %errorlevel% neq 0 exit /b %errorlevel% +WHERE mage +IF %ERRORLEVEL% NEQ 0 go install github.com/elastic/beats/vendor/github.com/magefile/mage -echo Success +mage %* diff --git a/packetbeat/Makefile b/packetbeat/Makefile index 7c0b53258343..03ed18219db9 100644 --- a/packetbeat/Makefile +++ b/packetbeat/Makefile @@ -3,7 +3,6 @@ BEAT_TITLE?=Packetbeat SYSTEM_TESTS?=true TEST_ENVIRONMENT=false ES_BEATS?=.. -FIELDS_FILE_PATH=protos include ${ES_BEATS}/libbeat/scripts/Makefile diff --git a/packetbeat/magefile.go b/packetbeat/magefile.go index 98c37ea5167f..b002c88e69d3 100644 --- a/packetbeat/magefile.go +++ b/packetbeat/magefile.go @@ -118,6 +118,11 @@ func Update() error { return sh.Run("make", "update") } +// Fields generates a fields.yml for the Beat. +func Fields() error { + return mage.GenerateFieldsYAML("protos") +} + // ----------------------------------------------------------------------------- // Customizations specific to Packetbeat. // - Config file contains an OS specific device name (affects darwin, windows). diff --git a/packetbeat/make.bat b/packetbeat/make.bat new file mode 100644 index 000000000000..81de1ba946f9 --- /dev/null +++ b/packetbeat/make.bat @@ -0,0 +1,11 @@ +@echo off + +REM Windows wrapper for Mage (https://magefile.org/) that installs it +REM to %GOPATH%\bin from the Beats vendor directory. +REM +REM After running this once you may invoke mage.exe directly. + +WHERE mage +IF %ERRORLEVEL% NEQ 0 go install github.com/elastic/beats/vendor/github.com/magefile/mage + +mage %* diff --git a/winlogbeat/magefile.go b/winlogbeat/magefile.go index 5500f9fdca8e..1d8ad837d83a 100644 --- a/winlogbeat/magefile.go +++ b/winlogbeat/magefile.go @@ -88,3 +88,8 @@ func TestPackages() error { func Update() error { return sh.Run("make", "update") } + +// Fields generates a fields.yml for the Beat. +func Fields() error { + return mage.GenerateFieldsYAML() +} diff --git a/winlogbeat/make.bat b/winlogbeat/make.bat index 0a46f8949b6a..81de1ba946f9 100644 --- a/winlogbeat/make.bat +++ b/winlogbeat/make.bat @@ -1,34 +1,11 @@ @echo off +REM Windows wrapper for Mage (https://magefile.org/) that installs it +REM to %GOPATH%\bin from the Beats vendor directory. REM -REM Batch script to build and test on Windows. You can use this in conjunction -REM with the Vagrant machine. -REM - -go install github.com/elastic/beats/vendor/github.com/pierrre/gotestcover -if %errorlevel% neq 0 exit /b %errorlevel% - -echo Building -go build -if %errorlevel% neq 0 exit /b %errorlevel% - -echo Testing -mkdir build\coverage -gotestcover -race -coverprofile=build/coverage/integration.cov github.com/elastic/beats/winlogbeat/... -if %errorlevel% neq 0 exit /b %errorlevel% - -echo System Testing -go test -c -covermode=atomic -coverpkg ./... -if %errorlevel% neq 0 exit /b %errorlevel% -nosetests -v -w tests\system --process-timeout=30 -if %errorlevel% neq 0 exit /b %errorlevel% +REM After running this once you may invoke mage.exe directly. -echo Aggregating Coverage Reports -python ..\dev-tools\aggregate_coverage.py -o build\coverage\system.cov .\build\system-tests\run -if %errorlevel% neq 0 exit /b %errorlevel% -python ..\dev-tools\aggregate_coverage.py -o build\coverage\full.cov .\build\coverage -if %errorlevel% neq 0 exit /b %errorlevel% -go tool cover -html=build\coverage\full.cov -o build\coverage\full.html -if %errorlevel% neq 0 exit /b %errorlevel% +WHERE mage +IF %ERRORLEVEL% NEQ 0 go install github.com/elastic/beats/vendor/github.com/magefile/mage -echo Success +mage %* From 623be88feced0ac25ac8f1a642af97128050a9bb Mon Sep 17 00:00:00 2001 From: Steffen Siering Date: Tue, 24 Jul 2018 08:43:45 +0200 Subject: [PATCH 32/34] Update go-ucfg to 0.6.1 (#7599) Update fixes config unpacking if users overwrite settings from CLI, with missing values. When using `-E key=` (e.g. in scripts defining potential empty defaults via env variables like `-E key=${MYVALUE}`), an untyped `nil`-values was inserted into the config. This untyped value will make Unpack fail for most typed settings. --- CHANGELOG.asciidoc | 1 + NOTICE.txt | 4 +- .../github.com/elastic/go-ucfg/CHANGELOG.md | 8 ++- vendor/github.com/elastic/go-ucfg/README.md | 15 +++--- .../github.com/elastic/go-ucfg/flag/value.go | 4 ++ vendor/vendor.json | 52 +++++++++---------- 6 files changed, 47 insertions(+), 37 deletions(-) diff --git a/CHANGELOG.asciidoc b/CHANGELOG.asciidoc index 9f658c7eb205..cb424dc4733c 100644 --- a/CHANGELOG.asciidoc +++ b/CHANGELOG.asciidoc @@ -79,6 +79,7 @@ https://github.com/elastic/beats/compare/v6.2.3...master[Check the HEAD diff] - Fix default value for logging.files.keepfiles. It was being set to 0 and now it's set to the documented value of 7. {issue}7494[7494] - Retain compatibility with older Docker server versions. {issue}7542[7542] +- Fix errors unpacking configs modified via CLI by ignoring `-E key=value` pairs with missing value. {pull}7599[7599] *Auditbeat* diff --git a/NOTICE.txt b/NOTICE.txt index bfbb7db2017e..31d8d98bce37 100644 --- a/NOTICE.txt +++ b/NOTICE.txt @@ -446,8 +446,8 @@ Apache License 2.0 -------------------------------------------------------------------- Dependency: github.com/elastic/go-ucfg -Version: v0.6.0 -Revision: 9c66f5c432b1d25bdb449a1e588d58b5d0cd7268 +Version: v0.6.1 +Revision: 581f7b1fe9d84f4c18ef0694d6e0eb944a925dae License type (autodetected): Apache-2.0 ./vendor/github.com/elastic/go-ucfg/LICENSE: -------------------------------------------------------------------- diff --git a/vendor/github.com/elastic/go-ucfg/CHANGELOG.md b/vendor/github.com/elastic/go-ucfg/CHANGELOG.md index dd64f2609c7b..53a0e6169d68 100644 --- a/vendor/github.com/elastic/go-ucfg/CHANGELOG.md +++ b/vendor/github.com/elastic/go-ucfg/CHANGELOG.md @@ -14,6 +14,11 @@ This project adheres to [Semantic Versioning](http://semver.org/). ### Fixed +## [0.6.1] + +### Fixed +- Ignore flag keys with missing values. #111 + ## [0.6.0] ### Added @@ -197,7 +202,8 @@ This project adheres to [Semantic Versioning](http://semver.org/). - Introduced CHANGELOG.md for documenting changes to ucfg. -[Unreleased]: https://github.com/elastic/go-ucfg/compare/v0.6.0...HEAD +[Unreleased]: https://github.com/elastic/go-ucfg/compare/v0.6.1...HEAD +[0.6.1]: https://github.com/elastic/go-ucfg/compare/v0.6.0...v0.6.1 [0.6.0]: https://github.com/elastic/go-ucfg/compare/v0.5.1...v0.6.0 [0.5.1]: https://github.com/elastic/go-ucfg/compare/v0.5.0...v0.5.1 [0.5.0]: https://github.com/elastic/go-ucfg/compare/v0.4.6...v0.5.0 diff --git a/vendor/github.com/elastic/go-ucfg/README.md b/vendor/github.com/elastic/go-ucfg/README.md index 446a179703bf..515d38d5f9c1 100644 --- a/vendor/github.com/elastic/go-ucfg/README.md +++ b/vendor/github.com/elastic/go-ucfg/README.md @@ -17,26 +17,25 @@ The full API Documentation can be found [here](https://godoc.org/github.com/elas A few examples on how ucfg can be used. All examples below assume, that the following packages are imported: -``` +```golang import ( "github.com/elastic/go-ucfg" "github.com/elastic/go-ucfg/yaml" ) ``` - -### Dot notations +### Dot notations ufcg allows you to load yaml configuration files using dots instead of indentation. For example instead of having: -``` +```yaml config: user: name ``` with ucfg you can write: -``` +```yaml config.user: name ``` @@ -44,7 +43,7 @@ This makes configurations easier and simpler. To load such a config file in Golang, use the following command: -``` +```golang config, err := yaml.NewConfigWithFile(path, ucfg.PathSep(".")) ``` @@ -55,7 +54,7 @@ config, err := yaml.NewConfigWithFile(path, ucfg.PathSep(".")) ucfg allows to automatically validate fields and set defaults for fields in case they are not defined. -``` +```golang // Defines struct to read config from type ExampleConfig struct { Counter string `config:"counter" validate:"min=0, max=9"` @@ -90,4 +89,4 @@ The above uses `Counter` as the config variable. ucfg assures that the value is ucfg has the following requirements: -* Golang 1.5+ +* Golang 1.7+ diff --git a/vendor/github.com/elastic/go-ucfg/flag/value.go b/vendor/github.com/elastic/go-ucfg/flag/value.go index 782cfc06f479..f75816badb76 100644 --- a/vendor/github.com/elastic/go-ucfg/flag/value.go +++ b/vendor/github.com/elastic/go-ucfg/flag/value.go @@ -62,6 +62,10 @@ func NewFlagKeyValue(cfg *ucfg.Config, autoBool bool, opts ...ucfg.Option) *Flag val = true } else { key = args[0] + if args[1] == "" { + return nil, nil, nil + } + val, err = parse.Value(args[1]) if err != nil { return nil, err, err diff --git a/vendor/vendor.json b/vendor/vendor.json index 07c356ac4434..c557ced2e254 100644 --- a/vendor/vendor.json +++ b/vendor/vendor.json @@ -623,52 +623,52 @@ "versionExact": "v0.0.1" }, { - "checksumSHA1": "d0qibYdQy5G1YqI5H+xNC0QJ66g=", + "checksumSHA1": "MK8/w0Idj7kRBUiBabARPdm9hOo=", "path": "github.com/elastic/go-ucfg", - "revision": "9c66f5c432b1d25bdb449a1e588d58b5d0cd7268", - "revisionTime": "2018-07-04T14:42:58Z", - "version": "v0.6.0", - "versionExact": "v0.6.0" + "revision": "581f7b1fe9d84f4c18ef0694d6e0eb944a925dae", + "revisionTime": "2018-07-13T14:04:29Z", + "version": "v0.6.1", + "versionExact": "v0.6.1" }, { "checksumSHA1": "X+R/CD8SokJrmlxFTx2nSevRDhQ=", "path": "github.com/elastic/go-ucfg/cfgutil", - "revision": "9c66f5c432b1d25bdb449a1e588d58b5d0cd7268", - "revisionTime": "2018-07-04T14:42:58Z", - "version": "v0.6.0", - "versionExact": "v0.6.0" + "revision": "581f7b1fe9d84f4c18ef0694d6e0eb944a925dae", + "revisionTime": "2018-07-13T14:04:29Z", + "version": "v0.6.1", + "versionExact": "v0.6.1" }, { - "checksumSHA1": "dShGF53hLUufO70RAjju+RT0fHY=", + "checksumSHA1": "zC8mCPW/pPPNcuHQOc/B/Ej1W1U=", "path": "github.com/elastic/go-ucfg/flag", - "revision": "9c66f5c432b1d25bdb449a1e588d58b5d0cd7268", - "revisionTime": "2018-07-04T14:42:58Z", - "version": "v0.6.0", - "versionExact": "v0.6.0" + "revision": "581f7b1fe9d84f4c18ef0694d6e0eb944a925dae", + "revisionTime": "2018-07-13T14:04:29Z", + "version": "v0.6.1", + "versionExact": "v0.6.1" }, { "checksumSHA1": "esXpiQlEvTOUwsE0nNesso8albo=", "path": "github.com/elastic/go-ucfg/internal/parse", - "revision": "9c66f5c432b1d25bdb449a1e588d58b5d0cd7268", - "revisionTime": "2018-07-04T14:42:58Z", - "version": "v0.6.0", - "versionExact": "v0.6.0" + "revision": "581f7b1fe9d84f4c18ef0694d6e0eb944a925dae", + "revisionTime": "2018-07-13T14:04:29Z", + "version": "v0.6.1", + "versionExact": "v0.6.1" }, { "checksumSHA1": "5mXUhhlPdvcAFKiQENInTJWrtQM=", "path": "github.com/elastic/go-ucfg/json", - "revision": "9c66f5c432b1d25bdb449a1e588d58b5d0cd7268", - "revisionTime": "2018-07-04T14:42:58Z", - "version": "v0.6.0", - "versionExact": "v0.6.0" + "revision": "581f7b1fe9d84f4c18ef0694d6e0eb944a925dae", + "revisionTime": "2018-07-13T14:04:29Z", + "version": "v0.6.1", + "versionExact": "v0.6.1" }, { "checksumSHA1": "Bg6vistPQLftv2fEYB7GWwSExv8=", "path": "github.com/elastic/go-ucfg/yaml", - "revision": "9c66f5c432b1d25bdb449a1e588d58b5d0cd7268", - "revisionTime": "2018-07-04T14:42:58Z", - "version": "v0.6.0", - "versionExact": "v0.6.0" + "revision": "581f7b1fe9d84f4c18ef0694d6e0eb944a925dae", + "revisionTime": "2018-07-13T14:04:29Z", + "version": "v0.6.1", + "versionExact": "v0.6.1" }, { "checksumSHA1": "yu/X+qHftvfQlAnjPdYLwrDn2nI=", From db8dac87f05ada6d671f93f3f7f1552834d28a7d Mon Sep 17 00:00:00 2001 From: Silvia Mitter Date: Tue, 24 Jul 2018 10:01:36 +0200 Subject: [PATCH 33/34] Docs: Add deprecation check for dashboard loading. (#7675) For APM Server the recommended way of loading dashboards and Kibana index pattern will be through the Kibana UI from 6.4 on. Since the docs are based on the libbeat docs we need to add a deprecation flag for dashboard and index pattern related documentation. relates to https://github.com/elastic/apm-server/pull/1142 --- libbeat/docs/command-reference.asciidoc | 59 +++++++++++++++++++--- libbeat/docs/dashboardsconfig.asciidoc | 5 ++ libbeat/docs/outputconfig.asciidoc | 14 +++-- libbeat/docs/shared-kibana-config.asciidoc | 5 ++ libbeat/docs/shared-template-load.asciidoc | 19 +++++++ 5 files changed, 92 insertions(+), 10 deletions(-) diff --git a/libbeat/docs/command-reference.asciidoc b/libbeat/docs/command-reference.asciidoc index 346679fda615..e2f37f911aa5 100644 --- a/libbeat/docs/command-reference.asciidoc +++ b/libbeat/docs/command-reference.asciidoc @@ -20,12 +20,22 @@ :modules-command-short-desc: Manages configured modules :run-command-short-desc: Runs {beatname_uc}. This command is used by default if you start {beatname_uc} without specifying a command +ifndef::deprecate_dashboard_loading[] + ifdef::has_ml_jobs[] :setup-command-short-desc: Sets up the initial environment, including the index template, Kibana dashboards (when available), and machine learning jobs (when available) endif::[] ifndef::has_ml_jobs[] -:setup-command-short-desc: Sets up the initial environment, including the index template, Kibana dashboards (when available) +:setup-command-short-desc: Sets up the initial environment, including the index template and Kibana dashboards (when available) +endif::[] + +endif::[] + +ifdef::deprecate_dashboard_loading[] + +:setup-command-short-desc: Sets up the initial environment, including the ES index template and Kibana dashboards (deprecated). + endif::[] :test-command-short-desc: Tests the configuration @@ -39,9 +49,17 @@ endif::[] Command reference ++++ +ifndef::deprecate_dashboard_loading[] {beatname_uc} provides a command-line interface for starting {beatname_uc} and -performing common tasks, like testing configuration files and loading -dashboards. The command-line also supports <> +performing common tasks, like testing configuration files and loading dashboards. +endif::[] + +ifdef::deprecate_dashboard_loading[] +{beatname_uc} provides a command-line interface for starting {beatname_uc} and +performing common tasks, like testing configuration files and loading dashboards (deprecated). +endif::[] + +The command-line also supports <> for controlling global behaviors. ifeval::["{beatname_lc}"!="winlogbeat"] @@ -391,8 +409,19 @@ the end of the file is reached. By default harvesters are closed after endif::[] *`--setup`*:: -Loads the sample Kibana dashboards. If you want to load the dashboards without -running {beatname_uc}, use the <> command instead. +ifdef::deprecate_dashboard_loading[] +deprecated[{deprecate_dashboard_loading}] +endif::[] ++ +ifdef::has_ml_jobs[] +Loads the initial setup, including Elasticsearch template, Kibana index pattern, +Kibana dashboards and Machine learning jobs. +endif::[] +ifndef::has_ml_jobs[] +Loads the initial setup, including Elasticsearch template, Kibana index pattern and Kibana dashboards. +endif::[] +If you want to use the command without running {beatname_uc}, use the <> command instead. + ifeval::["{beatname_lc}"=="metricbeat"] @@ -431,13 +460,17 @@ Or: [[setup-command]] ==== `setup` command -{setup-command-short-desc}. +{setup-command-short-desc} * The index template ensures that fields are mapped correctly in Elasticsearch. + * The Kibana dashboards make it easier for you to visualize {beatname_uc} data in Kibana. + +ifdef::has_ml_jobs[] * The machine learning jobs contain the configuration information and metadata necessary to analyze data for anomalies. +endif::[] Use this command instead of `run --setup` when you want to set up the environment without actually running {beatname_uc} and ingesting data. @@ -452,18 +485,32 @@ environment without actually running {beatname_uc} and ingesting data. *FLAGS* +ifndef::deprecate_dashboard_loading[] *`--dashboards`*:: Sets up the Kibana dashboards only. This option loads the dashboards from the {beatname_uc} package. For more options, such as loading customized dashboards, see {beatsdevguide}/import-dashboards.html[Importing Existing Beat Dashboards] in the _Beats Developer Guide_. +endif::[] + +ifdef::deprecate_dashboard_loading[] +*`--dashboards`*:: + +deprecated[{deprecate_dashboard_loading}] ++ +Sets up the Kibana dashboards only. +endif::[] *`-h, --help`*:: Shows help for the `setup` command. +ifdef::has_ml_jobs[] + *`--machine-learning`*:: Sets up machine learning job configurations only. +endif::[] + ifeval::["{beatname_lc}"=="filebeat"] *`--modules MODULE_LIST`*:: diff --git a/libbeat/docs/dashboardsconfig.asciidoc b/libbeat/docs/dashboardsconfig.asciidoc index fbc9f1a202d7..83099f84d161 100644 --- a/libbeat/docs/dashboardsconfig.asciidoc +++ b/libbeat/docs/dashboardsconfig.asciidoc @@ -11,6 +11,11 @@ [[configuration-dashboards]] == Load the Kibana dashboards +ifdef::deprecate_dashboard_loading[] + +deprecated[{deprecate_dashboard_loading}] + +endif::[] {beatname_uc} comes packaged with example Kibana dashboards, visualizations, and searches for visualizing {beatname_uc} data in Kibana. diff --git a/libbeat/docs/outputconfig.asciidoc b/libbeat/docs/outputconfig.asciidoc index 34e8b6b65940..09c9ea2ebc98 100644 --- a/libbeat/docs/outputconfig.asciidoc +++ b/libbeat/docs/outputconfig.asciidoc @@ -216,10 +216,16 @@ The index name to write events to. The default is +"{beatname_lc}-%\{[beat.version]\}-%\{+yyyy.MM.dd\}"+ (for example, +"{beatname_lc}-{version}-2017.04.26"+). If you change this setting, you also need to configure the `setup.template.name` and `setup.template.pattern` options -(see <>). If you are using the pre-built Kibana -dashboards, you also need to set the `setup.dashboards.index` option (see -<>). +(see <>). +If you are using the pre-built Kibana dashboards, +you also need to set the `setup.dashboards.index` option (see <>). + +ifdef::deprecate_dashboard_loading[] + +deprecated[{deprecate_dashboard_loading}] + +endif::[] ===== `indices` @@ -378,7 +384,7 @@ The Logstash output sends events directly to Logstash by using the lumberjack protocol, which runs over TCP. Logstash allows for additional processing and routing of generated events. -include::../../libbeat/docs/shared-logstash-config.asciidoc[] +include::./shared-logstash-config.asciidoc[] ==== Accessing metadata fields diff --git a/libbeat/docs/shared-kibana-config.asciidoc b/libbeat/docs/shared-kibana-config.asciidoc index d373a5bc0b3d..51ba2f0c3e2c 100644 --- a/libbeat/docs/shared-kibana-config.asciidoc +++ b/libbeat/docs/shared-kibana-config.asciidoc @@ -11,6 +11,11 @@ [[setup-kibana-endpoint]] == Set up the Kibana endpoint +ifdef::deprecate_dashboard_loading[] + +deprecated[{deprecate_dashboard_loading}] + +endif::[] ifeval::["{beatname_lc}" == "apm-server"] The Kibana dashboards are loaded into Kibana via the Kibana API. diff --git a/libbeat/docs/shared-template-load.asciidoc b/libbeat/docs/shared-template-load.asciidoc index e3bc17cea90a..6f4f1c7da8ea 100644 --- a/libbeat/docs/shared-template-load.asciidoc +++ b/libbeat/docs/shared-template-load.asciidoc @@ -94,6 +94,8 @@ that you specify should include the root name of the index plus version and date information. You also need to configure the `setup.template.name` and `setup.template.pattern` options to match the new name. For example: + +ifndef::deprecate_dashboard_loading[] + ["source","sh",subs="attributes,callouts"] ----- output.elasticsearch.index: "customname-%{[beat.version]}-%{+yyyy.MM.dd}" @@ -101,11 +103,28 @@ setup.template.name: "customname" setup.template.pattern: "customname-*" setup.dashboards.index: "customname-*" <1> ----- + <1> If you plan to <>, also set this option to overwrite the index name defined in the dashboards and index pattern. +endif::[] + +ifdef::deprecate_dashboard_loading[] + +["source","sh",subs="attributes,callouts"] +----- +output.elasticsearch.index: "customname-%{[beat.version]}-%{+yyyy.MM.dd}" +setup.template.name: "customname" +setup.template.pattern: "customname-*" +----- ++ +Also ensure to change the index name accordingly in the Kibana dashboards, +when loading via the Kibana UI. + +endif::[] + See <> for the full list of configuration options. From 67fd3b81762d67340e674fc0a802b8545acb4a5f Mon Sep 17 00:00:00 2001 From: ruflin Date: Tue, 24 Jul 2018 12:29:14 +0200 Subject: [PATCH 34/34] Update expected filebeat module files for geoip change --- filebeat/module/icinga/startup/test/test.log-expected.json | 4 ++-- filebeat/module/iis/access/test/test.log-expected.json | 2 -- filebeat/module/iis/error/test/test.log-expected.json | 3 --- filebeat/module/nginx/access/test/test.log-expected.json | 3 --- filebeat/module/system/auth/test/test.log-expected.json | 1 - filebeat/module/traefik/access/test/test.log-expected.json | 1 - 6 files changed, 2 insertions(+), 12 deletions(-) diff --git a/filebeat/module/icinga/startup/test/test.log-expected.json b/filebeat/module/icinga/startup/test/test.log-expected.json index 2f8cd6198c4e..e8557301253f 100644 --- a/filebeat/module/icinga/startup/test/test.log-expected.json +++ b/filebeat/module/icinga/startup/test/test.log-expected.json @@ -1,6 +1,6 @@ [ { - "@timestamp": "2018-07-23T11:50:38.896Z", + "@timestamp": "2018-07-24T10:26:47.908Z", "fileset.module": "icinga", "fileset.name": "startup", "icinga.startup.facility": "cli", @@ -11,7 +11,7 @@ "prospector.type": "log" }, { - "@timestamp": "2018-07-23T11:50:38.896Z", + "@timestamp": "2018-07-24T10:26:47.908Z", "fileset.module": "icinga", "fileset.name": "startup", "icinga.startup.facility": "cli", diff --git a/filebeat/module/iis/access/test/test.log-expected.json b/filebeat/module/iis/access/test/test.log-expected.json index 78adf0ee379b..7544fbbb01d5 100644 --- a/filebeat/module/iis/access/test/test.log-expected.json +++ b/filebeat/module/iis/access/test/test.log-expected.json @@ -8,7 +8,6 @@ "iis.access.geoip.country_iso_code": "DE", "iis.access.geoip.location.lat": 52.5167, "iis.access.geoip.location.lon": 13.4, - "iis.access.geoip.region_iso_code": "DE-BE", "iis.access.geoip.region_name": "Land Berlin", "iis.access.method": "GET", "iis.access.port": "80", @@ -74,7 +73,6 @@ "iis.access.geoip.country_iso_code": "DE", "iis.access.geoip.location.lat": 52.5167, "iis.access.geoip.location.lon": 13.4, - "iis.access.geoip.region_iso_code": "DE-BE", "iis.access.geoip.region_name": "Land Berlin", "iis.access.hostname": "example.com", "iis.access.http_version": "1.1", diff --git a/filebeat/module/iis/error/test/test.log-expected.json b/filebeat/module/iis/error/test/test.log-expected.json index e565e78cd7bc..2730859e55b2 100644 --- a/filebeat/module/iis/error/test/test.log-expected.json +++ b/filebeat/module/iis/error/test/test.log-expected.json @@ -26,7 +26,6 @@ "iis.error.geoip.country_iso_code": "DE", "iis.error.geoip.location.lat": 52.5167, "iis.error.geoip.location.lon": 13.4, - "iis.error.geoip.region_iso_code": "DE-BE", "iis.error.geoip.region_name": "Land Berlin", "iis.error.http_version": "1.1", "iis.error.method": "GET", @@ -51,7 +50,6 @@ "iis.error.geoip.country_iso_code": "DE", "iis.error.geoip.location.lat": 52.5167, "iis.error.geoip.location.lon": 13.4, - "iis.error.geoip.region_iso_code": "DE-BE", "iis.error.geoip.region_name": "Land Berlin", "iis.error.http_version": "2.0", "iis.error.method": "GET", @@ -76,7 +74,6 @@ "iis.error.geoip.country_iso_code": "DE", "iis.error.geoip.location.lat": 52.5167, "iis.error.geoip.location.lon": 13.4, - "iis.error.geoip.region_iso_code": "DE-BE", "iis.error.geoip.region_name": "Land Berlin", "iis.error.queue_name": "-", "iis.error.reason_phrase": "Timer_MinBytesPerSecond", diff --git a/filebeat/module/nginx/access/test/test.log-expected.json b/filebeat/module/nginx/access/test/test.log-expected.json index d169272c44fc..1d8b69e5c70b 100644 --- a/filebeat/module/nginx/access/test/test.log-expected.json +++ b/filebeat/module/nginx/access/test/test.log-expected.json @@ -65,7 +65,6 @@ "nginx.access.geoip.country_iso_code": "DE", "nginx.access.geoip.location.lat": 52.5167, "nginx.access.geoip.location.lon": 13.4, - "nginx.access.geoip.region_iso_code": "DE-BE", "nginx.access.geoip.region_name": "Land Berlin", "nginx.access.http_version": "1.1", "nginx.access.method": "GET", @@ -101,7 +100,6 @@ "nginx.access.geoip.country_iso_code": "DE", "nginx.access.geoip.location.lat": 52.5167, "nginx.access.geoip.location.lon": 13.4, - "nginx.access.geoip.region_iso_code": "DE-BE", "nginx.access.geoip.region_name": "Land Berlin", "nginx.access.http_version": "1.1", "nginx.access.method": "GET", @@ -135,7 +133,6 @@ "nginx.access.geoip.country_iso_code": "US", "nginx.access.geoip.location.lat": 39.772, "nginx.access.geoip.location.lon": -89.6859, - "nginx.access.geoip.region_iso_code": "US-IL", "nginx.access.geoip.region_name": "Illinois", "nginx.access.http_version": "1.1", "nginx.access.method": "GET", diff --git a/filebeat/module/system/auth/test/test.log-expected.json b/filebeat/module/system/auth/test/test.log-expected.json index 93e792d5a2a4..276558f363ac 100644 --- a/filebeat/module/system/auth/test/test.log-expected.json +++ b/filebeat/module/system/auth/test/test.log-expected.json @@ -61,7 +61,6 @@ "system.auth.ssh.geoip.country_iso_code": "CN", "system.auth.ssh.geoip.location.lat": 22.5333, "system.auth.ssh.geoip.location.lon": 114.1333, - "system.auth.ssh.geoip.region_iso_code": "CN-44", "system.auth.ssh.geoip.region_name": "Guangdong", "system.auth.ssh.ip": "116.31.116.24", "system.auth.ssh.method": "password", diff --git a/filebeat/module/traefik/access/test/test.log-expected.json b/filebeat/module/traefik/access/test/test.log-expected.json index 623a948a340f..d75a0d93a44b 100644 --- a/filebeat/module/traefik/access/test/test.log-expected.json +++ b/filebeat/module/traefik/access/test/test.log-expected.json @@ -35,7 +35,6 @@ "traefik.access.geoip.country_iso_code": "DE", "traefik.access.geoip.location.lat": 52.5167, "traefik.access.geoip.location.lon": 13.4, - "traefik.access.geoip.region_iso_code": "DE-BE", "traefik.access.geoip.region_name": "Land Berlin", "traefik.access.http_version": "1.1", "traefik.access.method": "GET",