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

Sign up to get free protection for your applications and to get access to all the features.
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]