logstash-input-google_cloud_storage 0.9.0-java → 0.10.0-java

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (82) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +5 -0
  3. data/CONTRIBUTING.md +1 -1
  4. data/README.md +4 -3
  5. data/docs/index.asciidoc +224 -5
  6. data/lib/logstash-input-google_cloud_storage_jars.rb +32 -28
  7. data/lib/logstash/inputs/cloud_storage/blob_adapter.rb +0 -13
  8. data/lib/logstash/inputs/cloud_storage/blob_filter.rb +0 -14
  9. data/lib/logstash/inputs/cloud_storage/client.rb +0 -13
  10. data/lib/logstash/inputs/cloud_storage/file_reader.rb +2 -15
  11. data/lib/logstash/inputs/cloud_storage/processed_db.rb +0 -13
  12. data/lib/logstash/inputs/google_cloud_storage.rb +2 -15
  13. data/logstash-input-google_cloud_storage.gemspec +1 -1
  14. data/spec/inputs/cloud_storage/blob_adapter_spec.rb +0 -14
  15. data/spec/inputs/cloud_storage/blob_filter_spec.rb +0 -14
  16. data/spec/inputs/cloud_storage/client_spec.rb +1 -15
  17. data/spec/inputs/cloud_storage/file_reader_spec.rb +2 -16
  18. data/spec/inputs/cloud_storage/processed_db_spec.rb +0 -14
  19. data/spec/inputs/google_cloud_storage_spec.rb +1 -15
  20. data/vendor/jar-dependencies/com/fasterxml/jackson/core/jackson-core/2.9.6/jackson-core-2.9.6.jar +0 -0
  21. data/vendor/jar-dependencies/com/google/api-client/google-api-client/1.27.0/google-api-client-1.27.0.jar +0 -0
  22. data/vendor/jar-dependencies/com/google/api/api-common/1.7.0/api-common-1.7.0.jar +0 -0
  23. data/vendor/jar-dependencies/com/google/api/gax-httpjson/0.55.0/gax-httpjson-0.55.0.jar +0 -0
  24. data/vendor/jar-dependencies/com/google/api/gax/1.38.0/gax-1.38.0.jar +0 -0
  25. data/vendor/jar-dependencies/com/google/api/grpc/proto-google-common-protos/{1.7.0/proto-google-common-protos-1.7.0.jar → 1.12.0/proto-google-common-protos-1.12.0.jar} +0 -0
  26. data/vendor/jar-dependencies/com/google/api/grpc/proto-google-iam-v1/{0.8.0/proto-google-iam-v1-0.8.0.jar → 0.12.0/proto-google-iam-v1-0.12.0.jar} +0 -0
  27. data/vendor/jar-dependencies/com/google/apis/google-api-services-storage/v1-rev20181109-1.27.0/google-api-services-storage-v1-rev20181109-1.27.0.jar +0 -0
  28. data/vendor/jar-dependencies/com/google/auth/google-auth-library-credentials/0.12.0/google-auth-library-credentials-0.12.0.jar +0 -0
  29. data/vendor/jar-dependencies/com/google/auth/google-auth-library-oauth2-http/0.12.0/google-auth-library-oauth2-http-0.12.0.jar +0 -0
  30. data/vendor/jar-dependencies/com/google/cloud/google-cloud-core-http/1.62.0/google-cloud-core-http-1.62.0.jar +0 -0
  31. data/vendor/jar-dependencies/com/google/cloud/google-cloud-core/1.62.0/google-cloud-core-1.62.0.jar +0 -0
  32. data/vendor/jar-dependencies/com/google/cloud/google-cloud-storage/1.62.0/google-cloud-storage-1.62.0.jar +0 -0
  33. data/vendor/jar-dependencies/com/google/code/findbugs/jsr305/3.0.2/jsr305-3.0.2.jar +0 -0
  34. data/vendor/jar-dependencies/com/google/guava/guava/26.0-android/guava-26.0-android.jar +0 -0
  35. data/vendor/jar-dependencies/com/google/http-client/google-http-client-appengine/1.27.0/google-http-client-appengine-1.27.0.jar +0 -0
  36. data/vendor/jar-dependencies/com/google/http-client/google-http-client-jackson2/1.27.0/google-http-client-jackson2-1.27.0.jar +0 -0
  37. data/vendor/jar-dependencies/com/google/http-client/google-http-client/1.27.0/google-http-client-1.27.0.jar +0 -0
  38. data/vendor/jar-dependencies/com/google/j2objc/j2objc-annotations/1.1/j2objc-annotations-1.1.jar +0 -0
  39. data/vendor/jar-dependencies/com/google/oauth-client/google-oauth-client/1.27.0/google-oauth-client-1.27.0.jar +0 -0
  40. data/vendor/jar-dependencies/com/google/protobuf/protobuf-java-util/3.6.1/protobuf-java-util-3.6.1.jar +0 -0
  41. data/vendor/jar-dependencies/com/google/protobuf/protobuf-java/3.6.1/protobuf-java-3.6.1.jar +0 -0
  42. data/vendor/jar-dependencies/commons-codec/commons-codec/1.10/commons-codec-1.10.jar +0 -0
  43. data/vendor/jar-dependencies/commons-logging/commons-logging/1.2/commons-logging-1.2.jar +0 -0
  44. data/vendor/jar-dependencies/io/grpc/grpc-context/1.14.0/grpc-context-1.14.0.jar +0 -0
  45. data/vendor/jar-dependencies/io/opencensus/opencensus-api/0.17.0/opencensus-api-0.17.0.jar +0 -0
  46. data/vendor/jar-dependencies/io/opencensus/opencensus-contrib-http-util/0.17.0/opencensus-contrib-http-util-0.17.0.jar +0 -0
  47. data/vendor/jar-dependencies/javax/annotation/javax.annotation-api/1.2/javax.annotation-api-1.2.jar +0 -0
  48. data/vendor/jar-dependencies/org/apache/httpcomponents/httpclient/4.5.5/httpclient-4.5.5.jar +0 -0
  49. data/vendor/jar-dependencies/org/apache/httpcomponents/httpcore/4.4.9/httpcore-4.4.9.jar +0 -0
  50. data/vendor/jar-dependencies/org/checkerframework/checker-compat-qual/2.5.2/checker-compat-qual-2.5.2.jar +0 -0
  51. data/vendor/jar-dependencies/org/codehaus/mojo/animal-sniffer-annotations/1.14/animal-sniffer-annotations-1.14.jar +0 -0
  52. metadata +34 -34
  53. data/docs/configuration.asciidoc +0 -112
  54. data/docs/examples.asciidoc +0 -84
  55. data/docs/metadata.asciidoc +0 -20
  56. data/docs/resources.asciidoc +0 -6
  57. data/vendor/jar-dependencies/com/fasterxml/jackson/core/jackson-core/2.1.3/jackson-core-2.1.3.jar +0 -0
  58. data/vendor/jar-dependencies/com/google/api-client/google-api-client/1.23.0/google-api-client-1.23.0.jar +0 -0
  59. data/vendor/jar-dependencies/com/google/api/api-common/1.5.0/api-common-1.5.0.jar +0 -0
  60. data/vendor/jar-dependencies/com/google/api/gax-httpjson/0.40.0/gax-httpjson-0.40.0.jar +0 -0
  61. data/vendor/jar-dependencies/com/google/api/gax/1.23.0/gax-1.23.0.jar +0 -0
  62. data/vendor/jar-dependencies/com/google/apis/google-api-services-storage/v1-rev114-1.23.0/google-api-services-storage-v1-rev114-1.23.0.jar +0 -0
  63. data/vendor/jar-dependencies/com/google/auth/google-auth-library-credentials/0.9.0/google-auth-library-credentials-0.9.0.jar +0 -0
  64. data/vendor/jar-dependencies/com/google/auth/google-auth-library-oauth2-http/0.9.0/google-auth-library-oauth2-http-0.9.0.jar +0 -0
  65. data/vendor/jar-dependencies/com/google/cloud/google-cloud-core-http/1.25.0/google-cloud-core-http-1.25.0.jar +0 -0
  66. data/vendor/jar-dependencies/com/google/cloud/google-cloud-core/1.25.0/google-cloud-core-1.25.0.jar +0 -0
  67. data/vendor/jar-dependencies/com/google/cloud/google-cloud-storage/1.25.0/google-cloud-storage-1.25.0.jar +0 -0
  68. data/vendor/jar-dependencies/com/google/code/findbugs/jsr305/3.0.1/jsr305-3.0.1.jar +0 -0
  69. data/vendor/jar-dependencies/com/google/guava/guava/20.0/guava-20.0.jar +0 -0
  70. data/vendor/jar-dependencies/com/google/http-client/google-http-client-appengine/1.23.0/google-http-client-appengine-1.23.0.jar +0 -0
  71. data/vendor/jar-dependencies/com/google/http-client/google-http-client-jackson2/1.23.0/google-http-client-jackson2-1.23.0.jar +0 -0
  72. data/vendor/jar-dependencies/com/google/http-client/google-http-client/1.23.0/google-http-client-1.23.0.jar +0 -0
  73. data/vendor/jar-dependencies/com/google/oauth-client/google-oauth-client/1.23.0/google-oauth-client-1.23.0.jar +0 -0
  74. data/vendor/jar-dependencies/com/google/protobuf/protobuf-java-util/3.5.1/protobuf-java-util-3.5.1.jar +0 -0
  75. data/vendor/jar-dependencies/com/google/protobuf/protobuf-java/3.5.1/protobuf-java-3.5.1.jar +0 -0
  76. data/vendor/jar-dependencies/commons-codec/commons-codec/1.3/commons-codec-1.3.jar +0 -0
  77. data/vendor/jar-dependencies/commons-logging/commons-logging/1.1.1/commons-logging-1.1.1.jar +0 -0
  78. data/vendor/jar-dependencies/io/grpc/grpc-context/1.9.0/grpc-context-1.9.0.jar +0 -0
  79. data/vendor/jar-dependencies/io/opencensus/opencensus-api/0.11.1/opencensus-api-0.11.1.jar +0 -0
  80. data/vendor/jar-dependencies/io/opencensus/opencensus-contrib-http-util/0.11.1/opencensus-contrib-http-util-0.11.1.jar +0 -0
  81. data/vendor/jar-dependencies/org/apache/httpcomponents/httpclient/4.0.1/httpclient-4.0.1.jar +0 -0
  82. data/vendor/jar-dependencies/org/apache/httpcomponents/httpcore/4.0.1/httpcore-4.0.1.jar +0 -0
@@ -1,84 +0,0 @@
1
- ==== Example Configurations
2
-
3
- ===== Basic
4
-
5
- Basic configuration to read JSON logs every minute from `my-logs-bucket`.
6
- For example, https://cloud.google.com/stackdriver/[Stackdriver logs].
7
-
8
- [source,ruby]
9
- ----------------------------------
10
- input {
11
- google_cloud_storage {
12
- interval => 60
13
- bucket_id => "my-logs-bucket"
14
- json_key_file => "/home/user/key.json"
15
- file_matches => ".*json"
16
- codec => "json_lines"
17
- }
18
- }
19
- output { stdout { codec => rubydebug } }
20
- ----------------------------------
21
-
22
- ===== Idempotent Inserts into Elasticsearch
23
-
24
- If your pipeline might insert the same file multiple times you can use the `line_id` metadata key as a deterministic id.
25
-
26
- The ID has the format: `gs://<bucket_id>/<object_id>:<line_num>@<generation>`.
27
- `line_num` represents the nth event deserialized from the file starting at 1.
28
- `generation` is a unique id Cloud Storage generates for the object.
29
- When an object is overwritten it gets a new generation.
30
-
31
- [source,ruby]
32
- ----------------------------------
33
- input {
34
- google_cloud_storage {
35
- bucket_id => "batch-jobs-output"
36
- }
37
- }
38
-
39
- output {
40
- elasticsearch {
41
- document_id => "%{[@metadata][gcs][line_id]}"
42
- }
43
- }
44
- ----------------------------------
45
-
46
- ===== From Cloud Storage to BigQuery
47
-
48
-
49
- Extract data from Cloud Storage, transform it with Logstash and load it into BigQuery.
50
-
51
-
52
- [source,ruby]
53
- ----------------------------------
54
- input {
55
- google_cloud_storage {
56
- interval => 60
57
- bucket_id => "batch-jobs-output"
58
- file_matches => "purchases.*.csv"
59
- json_key_file => "/home/user/key.json"
60
- codec => "plain"
61
- }
62
- }
63
-
64
- filter {
65
- csv {
66
- columns => ["transaction", "sku", "price"]
67
- convert => {
68
- "transaction" => "integer"
69
- "price" => "float"
70
- }
71
- }
72
- }
73
-
74
- output {
75
- google_bigquery {
76
- project_id => "my-project"
77
- dataset => "logs"
78
- csv_schema => "transaction:INTEGER,sku:INTEGER,price:FLOAT"
79
- json_key_file => "/path/to/key.json"
80
- error_directory => "/tmp/bigquery-errors"
81
- ignore_unknown_values => true
82
- }
83
- }
84
- ----------------------------------
@@ -1,20 +0,0 @@
1
- ==== Metadata Attributes
2
-
3
- The plugin exposes several metadata attributes about the object being read.
4
- You can access these later in the pipeline to augment the data or perform conditional logic.
5
-
6
- [cols="<,<,<",options="header",]
7
- |=======================================================================
8
- | Key | Type | Description
9
- | `[@metadata][gcs][bucket]` | `string` | The name of the bucket the file was read from.
10
- | `[@metadata][gcs][name]` | `string` | The name of the object.
11
- | `[@metadata][gcs][metadata]` | `object` | A map of metadata on the object.
12
- | `[@metadata][gcs][md5]` | `string` | MD5 hash of the data. Encoded using base64.
13
- | `[@metadata][gcs][crc32c]` | `string` | CRC32c checksum, as described in RFC 4960. Encoded using base64 in big-endian byte order.
14
- | `[@metadata][gcs][generation]` | `long` | The content generation of the object. Used for object versioning
15
- | `[@metadata][gcs][line]` | `long` | The position of the event in the file. 1 indexed.
16
- | `[@metadata][gcs][line_id]` | `string` | A deterministic, unique ID describing this line. This lets you do idempotent inserts into Elasticsearch.
17
- |=======================================================================
18
-
19
- More information about object metadata can be found in the
20
- https://cloud.google.com/storage/docs/json_api/v1/objects[official documentation].
@@ -1,6 +0,0 @@
1
- ==== Additional Resources
2
-
3
- * https://cloud.google.com/storage/[Cloud Storage Homepage]
4
- * https://cloud.google.com/storage/pricing-summary/[Cloud Storage Pricing]
5
- * https://cloud.google.com/iam/docs/service-accounts[IAM Service Accounts]
6
- * https://cloud.google.com/docs/authentication/production[Application Default Credentials]