function::json_add_array_numeric_metric - Linux


function::json_add_array_numeric_metric inserts a numerical metric into a JSON string and appends it to an array. It’s commonly used in cloud functions and monitoring systems to build time series data and record performance metrics.


function::json_add_array_numeric_metric(str json, str key, double value) -> str


  • json: The JSON string to modify.
  • key: The key to set the value for.
  • value: The numerical value to set.


This command does not have any options or flags.


Example 1: Adding a single numeric metric

json=$(function::json_add_array_numeric_metric '{"metrics": []}' "latency" 125)

Example 2: Adding multiple numeric metrics

json=$(function::json_add_array_numeric_metric \
    '{ "metrics": [{"latency": 125}] }' "latency" 150)

Common Issues

  • Key not found: Ensure that the specified key exists in the JSON string.
  • Invalid JSON: The input JSON must be a valid JSON string.


This command can be combined with other commands to process JSON data in Linux scripts. For example, you could use grep to filter the modified JSON based on specific criteria:

filtered_json=$(grep "latency" "$json")

Related Commands

  • function::json_add_array_string_metric
  • function::json_add_array_bool_metric
  • jq(1) – A flexible command-line JSON processor