Skip to content

Commit 7d43b80

Browse files
gcf-owl-bot[bot]minherz
gcf-owl-bot[bot]
and
minherz
authored
feat: Log Analytics features of the Cloud Logging API (#1335)
* feat: Log Analytics features of the Cloud Logging API feat: Add ConfigServiceV2.CreateBucketAsync method for creating Log Buckets asynchronously feat: Add ConfigServiceV2.UpdateBucketAsync method for creating Log Buckets asynchronously feat: Add ConfigServiceV2.CreateLink method for creating linked datasets for Log Analytics Buckets feat: Add ConfigServiceV2.DeleteLink method for deleting linked datasets feat: Add ConfigServiceV2.ListLinks method for listing linked datasets feat: Add ConfigServiceV2.GetLink methods for describing linked datasets feat: Add LogBucket.analytics_enabled field that specifies whether Log Bucket's Analytics features are enabled feat: Add LogBucket.index_configs field that contains a list of Log Bucket's indexed fields and related configuration data docs: Documentation for the Log Analytics features of the Cloud Logging API PiperOrigin-RevId: 529851525 Source-Link: googleapis/googleapis@1c7ee99 Source-Link: https://github.com/googleapis/googleapis-gen/commit/4a2a3a05b91804333a1b39b635d8fe2243d4b4fd Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNGEyYTNhMDViOTE4MDQzMzNhMWIzOWI2MzVkOGZlMjI0M2Q0YjRmZCJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md * chore: Ignore clirr errors for 7012 Ignore clirr difference '7012: Method Added to Interface' for methods createBucketAsync, updateBucketAsync, createLink, deleteLink, getLink and listLinks added to com.google.logging.v2.ConfigServiceV2Grpc$AsyncService interface. --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com> Co-authored-by: minherz <minherz@gmail.com>
1 parent f6accf8 commit 7d43b80

File tree

89 files changed

+22227
-2718
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

89 files changed

+22227
-2718
lines changed

‎google-cloud-logging/src/main/java/com/google/cloud/logging/v2/ConfigClient.java‎

Lines changed: 1106 additions & 191 deletions
Large diffs are not rendered by default.

‎google-cloud-logging/src/main/java/com/google/cloud/logging/v2/ConfigSettings.java‎

Lines changed: 119 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@
1818

1919
import static com.google.cloud.logging.v2.ConfigClient.ListBucketsPagedResponse;
2020
import static com.google.cloud.logging.v2.ConfigClient.ListExclusionsPagedResponse;
21+
import static com.google.cloud.logging.v2.ConfigClient.ListLinksPagedResponse;
2122
import static com.google.cloud.logging.v2.ConfigClient.ListSinksPagedResponse;
2223
import static com.google.cloud.logging.v2.ConfigClient.ListViewsPagedResponse;
2324

@@ -34,28 +35,36 @@
3435
import com.google.api.gax.rpc.TransportChannelProvider;
3536
import com.google.api.gax.rpc.UnaryCallSettings;
3637
import com.google.cloud.logging.v2.stub.ConfigServiceV2StubSettings;
38+
import com.google.logging.v2.BucketMetadata;
3739
import com.google.logging.v2.CmekSettings;
3840
import com.google.logging.v2.CopyLogEntriesMetadata;
3941
import com.google.logging.v2.CopyLogEntriesRequest;
4042
import com.google.logging.v2.CopyLogEntriesResponse;
4143
import com.google.logging.v2.CreateBucketRequest;
4244
import com.google.logging.v2.CreateExclusionRequest;
45+
import com.google.logging.v2.CreateLinkRequest;
4346
import com.google.logging.v2.CreateSinkRequest;
4447
import com.google.logging.v2.CreateViewRequest;
4548
import com.google.logging.v2.DeleteBucketRequest;
4649
import com.google.logging.v2.DeleteExclusionRequest;
50+
import com.google.logging.v2.DeleteLinkRequest;
4751
import com.google.logging.v2.DeleteSinkRequest;
4852
import com.google.logging.v2.DeleteViewRequest;
4953
import com.google.logging.v2.GetBucketRequest;
5054
import com.google.logging.v2.GetCmekSettingsRequest;
5155
import com.google.logging.v2.GetExclusionRequest;
56+
import com.google.logging.v2.GetLinkRequest;
5257
import com.google.logging.v2.GetSettingsRequest;
5358
import com.google.logging.v2.GetSinkRequest;
5459
import com.google.logging.v2.GetViewRequest;
60+
import com.google.logging.v2.Link;
61+
import com.google.logging.v2.LinkMetadata;
5562
import com.google.logging.v2.ListBucketsRequest;
5663
import com.google.logging.v2.ListBucketsResponse;
5764
import com.google.logging.v2.ListExclusionsRequest;
5865
import com.google.logging.v2.ListExclusionsResponse;
66+
import com.google.logging.v2.ListLinksRequest;
67+
import com.google.logging.v2.ListLinksResponse;
5968
import com.google.logging.v2.ListSinksRequest;
6069
import com.google.logging.v2.ListSinksResponse;
6170
import com.google.logging.v2.ListViewsRequest;
@@ -128,6 +137,28 @@ public UnaryCallSettings<GetBucketRequest, LogBucket> getBucketSettings() {
128137
return ((ConfigServiceV2StubSettings) getStubSettings()).getBucketSettings();
129138
}
130139

140+
/** Returns the object with the settings used for calls to createBucketAsync. */
141+
public UnaryCallSettings<CreateBucketRequest, Operation> createBucketAsyncSettings() {
142+
return ((ConfigServiceV2StubSettings) getStubSettings()).createBucketAsyncSettings();
143+
}
144+
145+
/** Returns the object with the settings used for calls to createBucketAsync. */
146+
public OperationCallSettings<CreateBucketRequest, LogBucket, BucketMetadata>
147+
createBucketAsyncOperationSettings() {
148+
return ((ConfigServiceV2StubSettings) getStubSettings()).createBucketAsyncOperationSettings();
149+
}
150+
151+
/** Returns the object with the settings used for calls to updateBucketAsync. */
152+
public UnaryCallSettings<UpdateBucketRequest, Operation> updateBucketAsyncSettings() {
153+
return ((ConfigServiceV2StubSettings) getStubSettings()).updateBucketAsyncSettings();
154+
}
155+
156+
/** Returns the object with the settings used for calls to updateBucketAsync. */
157+
public OperationCallSettings<UpdateBucketRequest, LogBucket, BucketMetadata>
158+
updateBucketAsyncOperationSettings() {
159+
return ((ConfigServiceV2StubSettings) getStubSettings()).updateBucketAsyncOperationSettings();
160+
}
161+
131162
/** Returns the object with the settings used for calls to createBucket. */
132163
public UnaryCallSettings<CreateBucketRequest, LogBucket> createBucketSettings() {
133164
return ((ConfigServiceV2StubSettings) getStubSettings()).createBucketSettings();
@@ -200,6 +231,39 @@ public UnaryCallSettings<DeleteSinkRequest, Empty> deleteSinkSettings() {
200231
return ((ConfigServiceV2StubSettings) getStubSettings()).deleteSinkSettings();
201232
}
202233

234+
/** Returns the object with the settings used for calls to createLink. */
235+
public UnaryCallSettings<CreateLinkRequest, Operation> createLinkSettings() {
236+
return ((ConfigServiceV2StubSettings) getStubSettings()).createLinkSettings();
237+
}
238+
239+
/** Returns the object with the settings used for calls to createLink. */
240+
public OperationCallSettings<CreateLinkRequest, Link, LinkMetadata>
241+
createLinkOperationSettings() {
242+
return ((ConfigServiceV2StubSettings) getStubSettings()).createLinkOperationSettings();
243+
}
244+
245+
/** Returns the object with the settings used for calls to deleteLink. */
246+
public UnaryCallSettings<DeleteLinkRequest, Operation> deleteLinkSettings() {
247+
return ((ConfigServiceV2StubSettings) getStubSettings()).deleteLinkSettings();
248+
}
249+
250+
/** Returns the object with the settings used for calls to deleteLink. */
251+
public OperationCallSettings<DeleteLinkRequest, Empty, LinkMetadata>
252+
deleteLinkOperationSettings() {
253+
return ((ConfigServiceV2StubSettings) getStubSettings()).deleteLinkOperationSettings();
254+
}
255+
256+
/** Returns the object with the settings used for calls to listLinks. */
257+
public PagedCallSettings<ListLinksRequest, ListLinksResponse, ListLinksPagedResponse>
258+
listLinksSettings() {
259+
return ((ConfigServiceV2StubSettings) getStubSettings()).listLinksSettings();
260+
}
261+
262+
/** Returns the object with the settings used for calls to getLink. */
263+
public UnaryCallSettings<GetLinkRequest, Link> getLinkSettings() {
264+
return ((ConfigServiceV2StubSettings) getStubSettings()).getLinkSettings();
265+
}
266+
203267
/** Returns the object with the settings used for calls to listExclusions. */
204268
public PagedCallSettings<
205269
ListExclusionsRequest, ListExclusionsResponse, ListExclusionsPagedResponse>
@@ -367,6 +431,28 @@ public UnaryCallSettings.Builder<GetBucketRequest, LogBucket> getBucketSettings(
367431
return getStubSettingsBuilder().getBucketSettings();
368432
}
369433

434+
/** Returns the builder for the settings used for calls to createBucketAsync. */
435+
public UnaryCallSettings.Builder<CreateBucketRequest, Operation> createBucketAsyncSettings() {
436+
return getStubSettingsBuilder().createBucketAsyncSettings();
437+
}
438+
439+
/** Returns the builder for the settings used for calls to createBucketAsync. */
440+
public OperationCallSettings.Builder<CreateBucketRequest, LogBucket, BucketMetadata>
441+
createBucketAsyncOperationSettings() {
442+
return getStubSettingsBuilder().createBucketAsyncOperationSettings();
443+
}
444+
445+
/** Returns the builder for the settings used for calls to updateBucketAsync. */
446+
public UnaryCallSettings.Builder<UpdateBucketRequest, Operation> updateBucketAsyncSettings() {
447+
return getStubSettingsBuilder().updateBucketAsyncSettings();
448+
}
449+
450+
/** Returns the builder for the settings used for calls to updateBucketAsync. */
451+
public OperationCallSettings.Builder<UpdateBucketRequest, LogBucket, BucketMetadata>
452+
updateBucketAsyncOperationSettings() {
453+
return getStubSettingsBuilder().updateBucketAsyncOperationSettings();
454+
}
455+
370456
/** Returns the builder for the settings used for calls to createBucket. */
371457
public UnaryCallSettings.Builder<CreateBucketRequest, LogBucket> createBucketSettings() {
372458
return getStubSettingsBuilder().createBucketSettings();
@@ -439,6 +525,39 @@ public UnaryCallSettings.Builder<DeleteSinkRequest, Empty> deleteSinkSettings()
439525
return getStubSettingsBuilder().deleteSinkSettings();
440526
}
441527

528+
/** Returns the builder for the settings used for calls to createLink. */
529+
public UnaryCallSettings.Builder<CreateLinkRequest, Operation> createLinkSettings() {
530+
return getStubSettingsBuilder().createLinkSettings();
531+
}
532+
533+
/** Returns the builder for the settings used for calls to createLink. */
534+
public OperationCallSettings.Builder<CreateLinkRequest, Link, LinkMetadata>
535+
createLinkOperationSettings() {
536+
return getStubSettingsBuilder().createLinkOperationSettings();
537+
}
538+
539+
/** Returns the builder for the settings used for calls to deleteLink. */
540+
public UnaryCallSettings.Builder<DeleteLinkRequest, Operation> deleteLinkSettings() {
541+
return getStubSettingsBuilder().deleteLinkSettings();
542+
}
543+
544+
/** Returns the builder for the settings used for calls to deleteLink. */
545+
public OperationCallSettings.Builder<DeleteLinkRequest, Empty, LinkMetadata>
546+
deleteLinkOperationSettings() {
547+
return getStubSettingsBuilder().deleteLinkOperationSettings();
548+
}
549+
550+
/** Returns the builder for the settings used for calls to listLinks. */
551+
public PagedCallSettings.Builder<ListLinksRequest, ListLinksResponse, ListLinksPagedResponse>
552+
listLinksSettings() {
553+
return getStubSettingsBuilder().listLinksSettings();
554+
}
555+
556+
/** Returns the builder for the settings used for calls to getLink. */
557+
public UnaryCallSettings.Builder<GetLinkRequest, Link> getLinkSettings() {
558+
return getStubSettingsBuilder().getLinkSettings();
559+
}
560+
442561
/** Returns the builder for the settings used for calls to listExclusions. */
443562
public PagedCallSettings.Builder<
444563
ListExclusionsRequest, ListExclusionsResponse, ListExclusionsPagedResponse>

‎google-cloud-logging/src/main/java/com/google/cloud/logging/v2/LoggingClient.java‎

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -597,13 +597,12 @@ public final WriteLogEntriesResponse writeLogEntries(WriteLogEntriesRequest requ
597597
* &#42;
598598
* `billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]`
599599
* &#42; `folders/[FOLDER_ID]/locations/[LOCATION_ID]/buckets/[BUCKET_ID]/views/[VIEW_ID]`
600-
* <p>Projects listed in the `project_ids` field are added to this list.
601-
* @param filter Optional. A filter that chooses which log entries to return. See [Advanced Logs
602-
* Queries](https://cloud.google.com/logging/docs/view/advanced-queries). Only log entries
603-
* that match the filter are returned. An empty filter matches all log entries in the
604-
* resources listed in `resource_names`. Referencing a parent resource that is not listed in
605-
* `resource_names` will cause the filter to return no results. The maximum length of the
606-
* filter is 20000 characters.
600+
* <p>Projects listed in the `project_ids` field are added to this list. A maximum of 100
601+
* resources may be specified in a single request.
602+
* @param filter Optional. Only log entries that match the filter are returned. An empty filter
603+
* matches all log entries in the resources listed in `resource_names`. Referencing a parent
604+
* resource that is not listed in `resource_names` will cause the filter to return no results.
605+
* The maximum length of a filter is 20,000 characters.
607606
* @param orderBy Optional. How the results should be sorted. Presently, the only permitted values
608607
* are `"timestamp asc"` (default) and `"timestamp desc"`. The first option returns entries in
609608
* order of increasing values of `LogEntry.timestamp` (oldest first), and the second option
@@ -864,7 +863,7 @@ public final ListMonitoredResourceDescriptorsPagedResponse listMonitoredResource
864863
* }
865864
* }</pre>
866865
*
867-
* @param parent Required. The resource name that owns the logs:
866+
* @param parent Required. The resource name to list logs for:
868867
* <ul>
869868
* <li>`projects/[PROJECT_ID]`
870869
* <li>`organizations/[ORGANIZATION_ID]`
@@ -901,7 +900,7 @@ public final ListLogsPagedResponse listLogs(BillingAccountName parent) {
901900
* }
902901
* }</pre>
903902
*
904-
* @param parent Required. The resource name that owns the logs:
903+
* @param parent Required. The resource name to list logs for:
905904
* <ul>
906905
* <li>`projects/[PROJECT_ID]`
907906
* <li>`organizations/[ORGANIZATION_ID]`
@@ -938,7 +937,7 @@ public final ListLogsPagedResponse listLogs(FolderName parent) {
938937
* }
939938
* }</pre>
940939
*
941-
* @param parent Required. The resource name that owns the logs:
940+
* @param parent Required. The resource name to list logs for:
942941
* <ul>
943942
* <li>`projects/[PROJECT_ID]`
944943
* <li>`organizations/[ORGANIZATION_ID]`
@@ -975,7 +974,7 @@ public final ListLogsPagedResponse listLogs(OrganizationName parent) {
975974
* }
976975
* }</pre>
977976
*
978-
* @param parent Required. The resource name that owns the logs:
977+
* @param parent Required. The resource name to list logs for:
979978
* <ul>
980979
* <li>`projects/[PROJECT_ID]`
981980
* <li>`organizations/[ORGANIZATION_ID]`
@@ -1012,7 +1011,7 @@ public final ListLogsPagedResponse listLogs(ProjectName parent) {
10121011
* }
10131012
* }</pre>
10141013
*
1015-
* @param parent Required. The resource name that owns the logs:
1014+
* @param parent Required. The resource name to list logs for:
10161015
* <ul>
10171016
* <li>`projects/[PROJECT_ID]`
10181017
* <li>`organizations/[ORGANIZATION_ID]`
@@ -1044,9 +1043,9 @@ public final ListLogsPagedResponse listLogs(String parent) {
10441043
* ListLogsRequest request =
10451044
* ListLogsRequest.newBuilder()
10461045
* .setParent(ProjectName.of("[PROJECT]").toString())
1046+
* .addAllResourceNames(new ArrayList<String>())
10471047
* .setPageSize(883849137)
10481048
* .setPageToken("pageToken873572522")
1049-
* .addAllResourceNames(new ArrayList<String>())
10501049
* .build();
10511050
* for (String element : loggingClient.listLogs(request).iterateAll()) {
10521051
* // doThingsWith(element);
@@ -1078,9 +1077,9 @@ public final ListLogsPagedResponse listLogs(ListLogsRequest request) {
10781077
* ListLogsRequest request =
10791078
* ListLogsRequest.newBuilder()
10801079
* .setParent(ProjectName.of("[PROJECT]").toString())
1080+
* .addAllResourceNames(new ArrayList<String>())
10811081
* .setPageSize(883849137)
10821082
* .setPageToken("pageToken873572522")
1083-
* .addAllResourceNames(new ArrayList<String>())
10841083
* .build();
10851084
* ApiFuture<String> future = loggingClient.listLogsPagedCallable().futureCall(request);
10861085
* // Do something.
@@ -1111,9 +1110,9 @@ public final UnaryCallable<ListLogsRequest, ListLogsPagedResponse> listLogsPaged
11111110
* ListLogsRequest request =
11121111
* ListLogsRequest.newBuilder()
11131112
* .setParent(ProjectName.of("[PROJECT]").toString())
1113+
* .addAllResourceNames(new ArrayList<String>())
11141114
* .setPageSize(883849137)
11151115
* .setPageToken("pageToken873572522")
1116-
* .addAllResourceNames(new ArrayList<String>())
11171116
* .build();
11181117
* while (true) {
11191118
* ListLogsResponse response = loggingClient.listLogsCallable().call(request);

‎google-cloud-logging/src/main/java/com/google/cloud/logging/v2/gapic_metadata.json‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,9 +43,15 @@
4343
"CreateBucket": {
4444
"methods": ["createBucket", "createBucketCallable"]
4545
},
46+
"CreateBucketAsync": {
47+
"methods": ["createBucketAsyncAsync", "createBucketAsyncOperationCallable", "createBucketAsyncCallable"]
48+
},
4649
"CreateExclusion": {
4750
"methods": ["createExclusion", "createExclusion", "createExclusion", "createExclusion", "createExclusion", "createExclusion", "createExclusionCallable"]
4851
},
52+
"CreateLink": {
53+
"methods": ["createLinkAsync", "createLinkAsync", "createLinkAsync", "createLinkOperationCallable", "createLinkCallable"]
54+
},
4955
"CreateSink": {
5056
"methods": ["createSink", "createSink", "createSink", "createSink", "createSink", "createSink", "createSinkCallable"]
5157
},
@@ -58,6 +64,9 @@
5864
"DeleteExclusion": {
5965
"methods": ["deleteExclusion", "deleteExclusion", "deleteExclusion", "deleteExclusionCallable"]
6066
},
67+
"DeleteLink": {
68+
"methods": ["deleteLinkAsync", "deleteLinkAsync", "deleteLinkAsync", "deleteLinkOperationCallable", "deleteLinkCallable"]
69+
},
6170
"DeleteSink": {
6271
"methods": ["deleteSink", "deleteSink", "deleteSink", "deleteSinkCallable"]
6372
},
@@ -73,6 +82,9 @@
7382
"GetExclusion": {
7483
"methods": ["getExclusion", "getExclusion", "getExclusion", "getExclusionCallable"]
7584
},
85+
"GetLink": {
86+
"methods": ["getLink", "getLink", "getLink", "getLinkCallable"]
87+
},
7688
"GetSettings": {
7789
"methods": ["getSettings", "getSettings", "getSettings", "getSettingsCallable"]
7890
},
@@ -88,6 +100,9 @@
88100
"ListExclusions": {
89101
"methods": ["listExclusions", "listExclusions", "listExclusions", "listExclusions", "listExclusions", "listExclusions", "listExclusionsPagedCallable", "listExclusionsCallable"]
90102
},
103+
"ListLinks": {
104+
"methods": ["listLinks", "listLinks", "listLinks", "listLinksPagedCallable", "listLinksCallable"]
105+
},
91106
"ListSinks": {
92107
"methods": ["listSinks", "listSinks", "listSinks", "listSinks", "listSinks", "listSinks", "listSinksPagedCallable", "listSinksCallable"]
93108
},
@@ -100,6 +115,9 @@
100115
"UpdateBucket": {
101116
"methods": ["updateBucket", "updateBucketCallable"]
102117
},
118+
"UpdateBucketAsync": {
119+
"methods": ["updateBucketAsyncAsync", "updateBucketAsyncOperationCallable", "updateBucketAsyncCallable"]
120+
},
103121
"UpdateCmekSettings": {
104122
"methods": ["updateCmekSettings", "updateCmekSettingsCallable"]
105123
},

0 commit comments

Comments
 (0)