@dynatrace-sdk/client-query 1.11.1 → 1.12.1
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.
- package/CHANGELOG.md +18 -0
- package/README.md +44 -28
- package/cjs/index.js +341 -241
- package/dynatrace-metadata.json +2 -2
- package/esm/index.js +341 -241
- package/package.json +2 -2
- package/types/packages/client/query/src/lib/models/error-response-details-constraint-violations-item.d.ts +14 -0
- package/types/packages/client/query/src/lib/models/error-response-details-constraint-violations-item.transformation.d.ts +10 -0
- package/types/packages/client/query/src/lib/models/error-response-details.d.ts +20 -7
- package/types/packages/client/query/src/lib/models/error-response-details.transformation.d.ts +11 -7
- package/types/packages/client/query/src/lib/models/error-response.d.ts +1 -1
- package/types/packages/client/query/src/lib/models/error-response.transformation.d.ts +1 -1
- package/types/packages/client/query/src/lib/models/index.d.ts +2 -0
- package/types/packages/http-client/src/lib/types/abort-signal.d.ts +4 -1
- package/docs/DOCS.md +0 -1207
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,24 @@
|
|
|
2
2
|
|
|
3
3
|
@dynatrace-sdk/client-query
|
|
4
4
|
|
|
5
|
+
## 1.12.1
|
|
6
|
+
|
|
7
|
+
### Patch Changes
|
|
8
|
+
|
|
9
|
+
- Updated boolean serialization handling. APPDEV-9047
|
|
10
|
+
|
|
11
|
+
## 1.12.0
|
|
12
|
+
|
|
13
|
+
### Minor Changes
|
|
14
|
+
|
|
15
|
+
- Client updated to support latest API changes. NOISSUE
|
|
16
|
+
- Updated dependencies
|
|
17
|
+
- @dynatrace-sdk/http-client@1.3.0
|
|
18
|
+
|
|
19
|
+
### Patch Changes
|
|
20
|
+
|
|
21
|
+
- Documentation removed from the package. APPDEV-8356
|
|
22
|
+
|
|
5
23
|
## 1.11.1
|
|
6
24
|
|
|
7
25
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# @dynatrace-sdk/client-query
|
|
2
2
|
|
|
3
|
-
[](https://www.npmjs.com/package/@dynatrace-sdk/client-query/v/1.12.1)
|
|
4
4
|
[](https://opensource.org/licenses/Apache-2.0)
|
|
5
5
|
|
|
6
6
|
Exposes an API to fetch records stored in Grail
|
|
@@ -826,7 +826,7 @@ The response for error state
|
|
|
826
826
|
| Name | Type | Description |
|
|
827
827
|
| --- | --- | --- |
|
|
828
828
|
|code<sup>*required</sup>|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Error code, which normally matches the HTTP error code. |
|
|
829
|
-
|details
|
|
829
|
+
|details|<a href="#errorresponsedetails" target="_blank" rel="noopener noreferrer">ErrorResponseDetails</a>| |
|
|
830
830
|
|message<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|A short, clear error message without details |
|
|
831
831
|
|
|
832
832
|
### ErrorResponseDetails
|
|
@@ -838,15 +838,31 @@ Detailed information about the error.
|
|
|
838
838
|
|
|
839
839
|
| Name | Type | Description |
|
|
840
840
|
| --- | --- | --- |
|
|
841
|
-
|arguments
|
|
842
|
-
|
|
|
843
|
-
|
|
|
844
|
-
|
|
|
845
|
-
|
|
|
846
|
-
|
|
|
841
|
+
|arguments|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|The arguments for the message format. |
|
|
842
|
+
|constraintViolations|Array<<a href="#errorresponsedetailsconstraintviolationsitem">ErrorResponseDetailsConstraintViolationsItem</a>>|Information about an input parameter that violated some validation rule of the service API. |
|
|
843
|
+
|errorMessage|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Complete error message. |
|
|
844
|
+
|errorMessageFormat|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The message format of the error message, string.format based. |
|
|
845
|
+
|errorMessageFormatSpecifierTypes|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|The corresponding DQL format specifier types for each format specifier used in the error message format. |
|
|
846
|
+
|errorType|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The error type, e.g. COMMAND_NAME_MISSING |
|
|
847
|
+
|exceptionType|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The exception type. |
|
|
848
|
+
|missingPermissions|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|List of missing IAM permissions necessary to successfully execute the request. |
|
|
849
|
+
|missingScopes|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|List of missing IAM scopes necessary to successfully execute the request. |
|
|
847
850
|
|queryId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |
|
|
848
|
-
|queryString
|
|
849
|
-
|syntaxErrorPosition|<a href="#tokenposition">TokenPosition</a>| |
|
|
851
|
+
|queryString|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Submitted query string. |
|
|
852
|
+
|syntaxErrorPosition|<a href="#tokenposition" target="_blank" rel="noopener noreferrer">TokenPosition</a>| |
|
|
853
|
+
|
|
854
|
+
### ErrorResponseDetailsConstraintViolationsItem
|
|
855
|
+
|
|
856
|
+
|
|
857
|
+
|
|
858
|
+
|
|
859
|
+
|
|
860
|
+
|
|
861
|
+
| Name | Type | Description |
|
|
862
|
+
| --- | --- | --- |
|
|
863
|
+
|message<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Message describing the error. |
|
|
864
|
+
|parameterDescriptor|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Describes the violating parameter. |
|
|
865
|
+
|parameterLocation|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Describes the general location of the violating parameter. |
|
|
850
866
|
|
|
851
867
|
### ExecuteRequest
|
|
852
868
|
|
|
@@ -867,7 +883,7 @@ Detailed information about the error.
|
|
|
867
883
|
|maxResultBytes|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The maximum number of result bytes that this query will return. |
|
|
868
884
|
|maxResultRecords|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The maximum number of result records that this query will return. |
|
|
869
885
|
|query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
|
|
870
|
-
|queryOptions|<a href="#queryoptions"
|
|
886
|
+
|queryOptions|<a href="#queryoptions">QueryOptions</a>| |
|
|
871
887
|
|requestTimeoutMilliseconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The time a client is willing to wait for the query result. In case the query finishes within the specified timeout, the query result is returned. Otherwise, the requestToken is returned, allowing polling for the result. |
|
|
872
888
|
|timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
|
|
873
889
|
|
|
@@ -881,7 +897,7 @@ The possible type of a field in DQL.
|
|
|
881
897
|
| Name | Type |
|
|
882
898
|
| --- | --- |
|
|
883
899
|
|type<sup>*required</sup>|FieldTypeType|
|
|
884
|
-
|types|Array<<a href="#rangedfieldtypes">RangedFieldTypes</a>>|
|
|
900
|
+
|types|Array<<a href="#rangedfieldtypes" target="_blank" rel="noopener noreferrer">RangedFieldTypes</a>>|
|
|
885
901
|
|
|
886
902
|
### GeoPoint
|
|
887
903
|
|
|
@@ -904,12 +920,12 @@ Collects various bits of metadata information.
|
|
|
904
920
|
|
|
905
921
|
| Name | Type | Description |
|
|
906
922
|
| --- | --- | --- |
|
|
907
|
-
|analysisTimeframe|<a href="#timeframe"
|
|
923
|
+
|analysisTimeframe|<a href="#timeframe">Timeframe</a>| |
|
|
908
924
|
|canonicalQuery|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The canonical form of the query. It has normalized spaces and canonical constructs. |
|
|
909
925
|
|dqlVersion|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The version of DQL that was used to process the query request. |
|
|
910
926
|
|executionTimeMilliseconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The time it took to execute the query. |
|
|
911
927
|
|locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|Effective locale for the query. |
|
|
912
|
-
|notifications|Array<<a href="#metadatanotification">MetadataNotification</a>>|Collected messages during the execution of the query. |
|
|
928
|
+
|notifications|Array<<a href="#metadatanotification" target="_blank" rel="noopener noreferrer">MetadataNotification</a>>|Collected messages during the execution of the query. |
|
|
913
929
|
|query|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The submitted query. |
|
|
914
930
|
|queryId|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The id of the query |
|
|
915
931
|
|sampled|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if sampling was used for at least one segment. |
|
|
@@ -927,8 +943,8 @@ Collects various bits of metadata information.
|
|
|
927
943
|
|
|
928
944
|
| Name | Type |
|
|
929
945
|
| --- | --- |
|
|
930
|
-
|grail|<a href="#grailmetadata"
|
|
931
|
-
|metrics|Array<<a href="#metricmetadata">MetricMetadata</a>>|
|
|
946
|
+
|grail|<a href="#grailmetadata">GrailMetadata</a>|
|
|
947
|
+
|metrics|Array<<a href="#metricmetadata" target="_blank" rel="noopener noreferrer">MetricMetadata</a>>|
|
|
932
948
|
|
|
933
949
|
### MetadataNotification
|
|
934
950
|
|
|
@@ -945,7 +961,7 @@ The message that provides additional information about the execution of the quer
|
|
|
945
961
|
|messageFormatSpecifierTypes|Array<[string](https://developer.mozilla.org/en-US/docs/Glossary/String)>|The corresponding DQL format specifier types for each format specifier used in the error message format. |
|
|
946
962
|
|notificationType|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The notification type, e.g. LIMIT_ADDED. |
|
|
947
963
|
|severity|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The severity of the notification, currently: INFO, WARN, ERROR. |
|
|
948
|
-
|syntaxPosition|<a href="#tokenposition"
|
|
964
|
+
|syntaxPosition|<a href="#tokenposition">TokenPosition</a>| |
|
|
949
965
|
|
|
950
966
|
### MetricMetadata
|
|
951
967
|
|
|
@@ -976,7 +992,7 @@ An object that defines additional metric metadata.
|
|
|
976
992
|
| --- | --- | --- |
|
|
977
993
|
|locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query locale. If none specified, then a language/country neutral locale is chosen. The input values take the ISO-639 Language code with an optional ISO-3166 country code appended to it with an underscore. For instance, both values are valid 'en' or 'en_US'. |
|
|
978
994
|
|query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
|
|
979
|
-
|queryOptions|<a href="#queryoptions">QueryOptions</a>| |
|
|
995
|
+
|queryOptions|<a href="#queryoptions" target="_blank" rel="noopener noreferrer">QueryOptions</a>| |
|
|
980
996
|
|timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
|
|
981
997
|
|
|
982
998
|
### PositionInfo
|
|
@@ -1009,7 +1025,7 @@ The response of GET query:execute call.
|
|
|
1009
1025
|
| Name | Type | Description |
|
|
1010
1026
|
| --- | --- | --- |
|
|
1011
1027
|
|progress|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The progress of the query from 0 to 100. |
|
|
1012
|
-
|result|<a href="#queryresult"
|
|
1028
|
+
|result|<a href="#queryresult">QueryResult</a>| |
|
|
1013
1029
|
|state<sup>*required</sup>|QueryState| |
|
|
1014
1030
|
|ttlSeconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Time to live in seconds. |
|
|
1015
1031
|
|
|
@@ -1022,9 +1038,9 @@ The result of the DQL query.
|
|
|
1022
1038
|
|
|
1023
1039
|
| Name | Type | Description |
|
|
1024
1040
|
| --- | --- | --- |
|
|
1025
|
-
|metadata<sup>*required</sup>|<a href="#metadata">Metadata</a>| |
|
|
1026
|
-
|records<sup>*required</sup>|Array<null | <a href="#resultrecord"
|
|
1027
|
-
|types<sup>*required</sup>|Array<<a href="#rangedfieldtypes">RangedFieldTypes</a>>|The data types for the result records. |
|
|
1041
|
+
|metadata<sup>*required</sup>|<a href="#metadata" target="_blank" rel="noopener noreferrer">Metadata</a>| |
|
|
1042
|
+
|records<sup>*required</sup>|Array<null | <a href="#resultrecord">ResultRecord</a>>|List of records containing the result fields data. |
|
|
1043
|
+
|types<sup>*required</sup>|Array<<a href="#rangedfieldtypes" target="_blank" rel="noopener noreferrer">RangedFieldTypes</a>>|The data types for the result records. |
|
|
1028
1044
|
|
|
1029
1045
|
### QueryStartResponse
|
|
1030
1046
|
|
|
@@ -1037,7 +1053,7 @@ The response when starting a query.
|
|
|
1037
1053
|
| --- | --- | --- |
|
|
1038
1054
|
|progress|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|The progress of the query from 0 to 100. |
|
|
1039
1055
|
|requestToken|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The token returned by the POST query:execute call. |
|
|
1040
|
-
|result|<a href="#queryresult"
|
|
1056
|
+
|result|<a href="#queryresult">QueryResult</a>| |
|
|
1041
1057
|
|state<sup>*required</sup>|QueryState| |
|
|
1042
1058
|
|ttlSeconds|[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)|Time to live in seconds. |
|
|
1043
1059
|
|
|
@@ -1051,7 +1067,7 @@ The field type in range.
|
|
|
1051
1067
|
| Name | Type | Description |
|
|
1052
1068
|
| --- | --- | --- |
|
|
1053
1069
|
|indexRange|Array<[number](https://developer.mozilla.org/en-US/docs/Glossary/Number)>|The range of elements at use this type in arrays (null for records). |
|
|
1054
|
-
|mappings<sup>*required</sup>|<a href="#rangedfieldtypesmappings">RangedFieldTypesMappings</a>| |
|
|
1070
|
+
|mappings<sup>*required</sup>|<a href="#rangedfieldtypesmappings" target="_blank" rel="noopener noreferrer">RangedFieldTypesMappings</a>| |
|
|
1055
1071
|
|
|
1056
1072
|
### RangedFieldTypesMappings
|
|
1057
1073
|
**type**: Record<string, FieldType | undefined>
|
|
@@ -1088,8 +1104,8 @@ The position of a token in a query string used for errors and notification to ma
|
|
|
1088
1104
|
|
|
1089
1105
|
| Name | Type |
|
|
1090
1106
|
| --- | --- |
|
|
1091
|
-
|end<sup>*required</sup>|<a href="#positioninfo"
|
|
1092
|
-
|start<sup>*required</sup>|<a href="#positioninfo">PositionInfo</a>|
|
|
1107
|
+
|end<sup>*required</sup>|<a href="#positioninfo">PositionInfo</a>|
|
|
1108
|
+
|start<sup>*required</sup>|<a href="#positioninfo" target="_blank" rel="noopener noreferrer">PositionInfo</a>|
|
|
1093
1109
|
|
|
1094
1110
|
### VerifyRequest
|
|
1095
1111
|
|
|
@@ -1103,7 +1119,7 @@ The position of a token in a query string used for errors and notification to ma
|
|
|
1103
1119
|
|generateCanonicalQuery|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)| <i>default:</i> <code>false</code>|
|
|
1104
1120
|
|locale|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query locale. If none specified, then a language/country neutral locale is chosen. The input values take the ISO-639 Language code with an optional ISO-3166 country code appended to it with an underscore. For instance, both values are valid 'en' or 'en_US'. |
|
|
1105
1121
|
|query<sup>*required</sup>|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The full query string. |
|
|
1106
|
-
|queryOptions|<a href="#queryoptions"
|
|
1122
|
+
|queryOptions|<a href="#queryoptions">QueryOptions</a>| |
|
|
1107
1123
|
|timezone|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)|The query timezone. If none is specified, UTC is used as fallback. The list of valid input values matches that of the IANA Time Zone Database (TZDB). It accepts values in their canonical names like 'Europe/Paris', the abbreviated version like CET or the UTC offset format like '+01:00' |
|
|
1108
1124
|
|
|
1109
1125
|
### VerifyResponse
|
|
@@ -1116,7 +1132,7 @@ Verify response.
|
|
|
1116
1132
|
| Name | Type | Description |
|
|
1117
1133
|
| --- | --- | --- |
|
|
1118
1134
|
|canonicalQuery|[string](https://developer.mozilla.org/en-US/docs/Glossary/String)| |
|
|
1119
|
-
|notifications|Array<<a href="#metadatanotification">MetadataNotification</a>>|The notifications related to the supplied DQL query string. |
|
|
1135
|
+
|notifications|Array<<a href="#metadatanotification" target="_blank" rel="noopener noreferrer">MetadataNotification</a>>|The notifications related to the supplied DQL query string. |
|
|
1120
1136
|
|valid<sup>*required</sup>|[boolean](https://developer.mozilla.org/en-US/docs/Glossary/Boolean)|True if the supplied DQL query string is valid. |
|
|
1121
1137
|
|
|
1122
1138
|
## Enums
|