Client Interface and Smart Contract Execution Engine Metrics Analysis on AWS

The metrics list is collected from the client interface and smart contract and sent to the metrics service for tracking. The collected metrics for analysis are, write a pipeline, validate a pipeline, and read a pipeline.

Write Pipeline Metrics

Metrics show the duration of the processes in the Ledger API server request before passing the API onto the Concord container.

Write Pipeline Metrics	Description
daml_lapi_command_submission_service_subm	Lists the time a request spent in the Daml Ledger API server. The time includes the duration request received through the gRPC until the request was passed on to the Concord container.
daml_execution_total	Lists the Daml interpretation interval of the request. The interval includes the time spent querying the index database for the stored information.
daml_execution_get_lf_package	Lists the time spent querying for the Daml LF packages required to interpret a request.
daml_execution_lookup_contract_key	Lists the time spent querying for smart contract keys required to interpret a request.
daml_execution_lookup_active_contract	Lists the time spent querying for active smart contracts required to interpret a request.
daml_services_write_submit_transaction	Lists the time spent sending the request to the Concord container.

Validate a Pipeline Metrics

Metrics show the interval of the request validation in the execution engine as part of the Concord container commitment algorithm.

Validate a Pipeline Metrics	Description
daml_kvutils_submission_validator_validate_and_commit	Lists the time the validator spent validating a batch of submissions.
daml_kvutils_submission_validator_open_envelope	Lists the time the validator spent opening the envelope of individual submissions within a batch.
daml_kvutils_submission_validator_decode	Lists the time the validator spent decoding individual submissions within a batch.
daml_kvutils_submission_validator_fetch_inputs	Lists the time the validator spent fetching inputs from the RocksDB for individual submissions within a batch.
daml_kvutils_submission_validator_validate	Lists the time the validator spent validating individual submissions within a batch.
daml_kvutils_committer_transaction_run_timer	Lists the time spent on validating the Daml transaction.
daml_kvutils_committer_transaction_interpret_timer	Lists the time spent on the interpretation segment of the Daml transaction validation.
daml_kvutils_committer_party_allocation_run_timer	Lists the time spent on validating a party allocation request.
daml_kvutils_committer_package_upload_run_timer	Lists the time spent on validating the package upload request.
daml_kvutils_submission_validator_detect_conflicts	Lists the time spent detecting the conflicts between the individual submissions within a batch.
daml_kvutils_submission_validator_commit	Lists the time spent on preparing the key-value pairs for committing.
daml_kvutils_submission_validator_batch_sizes	Lists the statistics of the batch sizes.
daml_kvutils_conflict_detection_accepted	Lists the number of individual submissions within batches accepted without conflicts.
daml_kvutils_conflict_detection_conflicted	Lists the number of individual submissions within batches rejected due to conflicts.
daml_kvutils_conflict_detection_removed_transient_key	Lists the number of individual submissions within batches that have been accepted after conflicting transient keys have been removed.

Read Pipeline Metrics

Metrics show the blocks received from the Concord container in the ledger API server.

Read Pipeline Metrics	Description
daml_trc_get_block	Lists the time spent acquiring a block from the thin replica client within the Client node.
daml_pkvutils_reader_parse_updates	Lists the time spent converting the data received in the block into a state update. State update is the internal data representation of the ledger API server.
daml_indexer_processed_state_updates	Lists the time spent on inserting a state update into the index database.
daml_index_db_get_flat_transactions_exec	Lists the time spent obtaining transaction information from the index database before passing the information to the ledger API client.
daml_indexer_current_record_time_lag	Shows delay between issuance of the block and moment that transaction in that block is registered into the index database.