AWS Timestream¶
The displayed Metrics for AWS Timestream include the number of system errors (internal service errors), the total number of invalid requests for the current AWS region and account, the elapsed time and sample count for successful requests, the amount of data stored in memory, and the amount of data stored on magnetic storage, among others.
Configuration¶
Install Func¶
It is recommended to enable Guance integration - extension - DataFlux Func (Automata): all prerequisites are automatically installed. Please continue with the script installation.
If you deploy Func manually, refer to Manual Func Deployment
Installation Script¶
Note: Please prepare an Amazon AK that meets the requirements in advance (for simplicity, you can directly grant global read-only permissions
ReadOnlyAccess
).
Script for Enabling Managed Version¶
- Log in to the Guance console.
- Click the 【Integration】 menu and select 【Cloud Account Management】.
- Click 【Add Cloud Account】, choose 【AWS】, and fill in the required information on the interface; if cloud account information has been configured before, skip this step.
- Click 【Test】. After a successful test, click 【Save】. If the test fails, check whether the related configuration information is correct and retest.
- In the 【Cloud Account Management】 list, you can see the added cloud accounts. Click the corresponding cloud account to enter the details page.
- On the cloud account details page, click the 【Integration】 button. Under the
Not Installed
list, findAWS Timestream
, click the 【Install】 button, and install it from the pop-up installation interface.
Manual Script for Enabling¶
-
Log in to the Func console, click 【Script Market】, enter the official script market, and search for
guance_aws_timestream
. -
After clicking 【Install】, input the corresponding parameters: AWS AK ID, AK Secret, and account name.
-
Click 【Deploy Startup Script】, and the system will automatically create a
Startup
script set and configure the corresponding startup scripts automatically. -
After enabling, you can see the corresponding automatic trigger configuration in 「Management / Automatic Trigger Configuration」. Click 【Execute】 to run immediately without waiting for the scheduled time. Wait a moment, and you can view the execution task records and corresponding logs.
We default collect some configurations; see the Metrics section for details.
Verification¶
- Confirm in 「Management / Automatic Trigger Configuration」 whether the corresponding tasks have the corresponding automatic trigger configurations. You can also check the corresponding task records and logs for any abnormalities.
- In Guance, under 「Infrastructure / Custom」, check if there is asset information.
- In Guance, under 「Metrics」, check if there are corresponding monitoring data.
Metrics¶
After configuring Amazon-CloudWatch, the default Measurement set is as follows. More Metrics can be collected through configuration:
Amazon CloudWatch AWS Timestream Metrics Details
Metric Name | Description | Unit | Valid Statistics |
---|---|---|---|
SystemErrors |
Requests to Timestream that generate system errors during the specified time period. System errors usually indicate internal service errors. | Count | Sum, SampleCount (displayed as Sample Count in the Amazon Timestream console) |
UserErrors |
Timestream requests that generate InvalidRequest errors during the specified time period. InvalidRequest typically indicates client-side errors such as invalid parameter combinations, attempts to update non-existent tables, or incorrect request signatures. UserErrors represent the total number of invalid requests for the current AWS region and account. | Count | Sum, SampleCount (displayed as Sample Count in the Amazon Timestream console) |
SuccessfulRequestLatency |
Successful requests to Timestream during the specified time period. SuccessfulRequestLatency can provide two types of information: the runtime of successful requests (Minimum, Maximum, Sum, or Average). The number of successful requests (SampleCount). SuccessfulRequestLatency only reflects activity within Timestream, not considering network latency or client-side activity. | Milliseconds | Average, Minimum, Maximum, Sum, SampleCount (displayed as Sample Count in the Amazon Timestream console) |
MemoryCumulativeBytesMetered |
The amount of data stored in memory, measured in bytes. | Bytes | Average |
MagneticCumulativeBytesMetered |
The amount of data stored on magnetic storage, measured in bytes. | Bytes | Average |