{"__v":4,"_id":"564514506b0ca50d00f6bda7","category":{"__v":5,"_id":"564514ff98da41190099f346","pages":["56451bbf98da41190099f352","56452bcc7f1fff210078e754","5645518cdecdee0d0090b786","56735fc247f7010d005bfdd6","5696fa4969393517000c8257"],"project":"5644e8bed608df0d00d269d9","version":"5644e8f22229d7170010923b","reference":false,"createdAt":"2015-11-12T22:38:55.104Z","from_sync":false,"order":3,"slug":"metric-data","title":"Metric Data"},"parentDoc":null,"project":"5644e8bed608df0d00d269d9","user":"5644e82bb360ea0d00914817","version":{"__v":15,"_id":"5644e8f22229d7170010923b","project":"5644e8bed608df0d00d269d9","createdAt":"2015-11-12T19:30:58.871Z","releaseDate":"2015-11-12T19:30:58.871Z","categories":["5644e8f32229d7170010923c","564514ff98da41190099f346","564523546b0ca50d00f6bdb8","564533dc6b0ca50d00f6bdcf","564535c16b0ca50d00f6bdd2","5645397a6b0ca50d00f6bddb","5645451eda14e70d0027cd2c","56454606decdee0d0090b774","564550e2bb7ad50d00e9c4ce","566f6768f11d5a0d007226e3","56a65b2f2ec8310d007bc1f2","56d77760693ef41d0003ac19","57151b8f11537f19006aab1e","5720e5dbdb52d01700f5d267","57487fd7db76422200d95873"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"2.0.0","version":"2"},"updates":[],"createdAt":"2015-11-12T22:36:00.557Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[{"language":"shell","code":"curl -i \\\n  -H \"Content-Type: application/json\" \\\n  -H \"X-SF-Token:[[app:API_TOKEN]]\" \\\n  -X POST \\\n  -d \\\n  '{ \n  \t\"gauge\": [{ \n    \t\"metric\": \"test.gauge\",\n      \"dimensions\": { \"host\": \"testserver\" }, \n      \"value\": 42 \n    }],\n    \"counter\": [{ \n    \t\"metric\": \"test.counter\",\n      \"dimensions\": { \"host\": \"testserver\" },\n      \"value\": 1\n    }],\n    \"cumulative_counter\": [{ \n    \t\"metric\": \"test.cumulative_counter\",\n      \"dimensions\": { \"host\": \"testserver\" },\n      \"value\": 100\n    }]  \n  }' \\\n  https://ingest.signalfx.com/v2/datapoint","name":""}]},"results":{"codes":[{"status":200,"language":"json","code":"\"OK\"","name":""},{"status":400,"language":"json","code":"<string error message>","name":""},{"status":401,"language":"text","code":"\"Unauthorized\""}]},"settings":"56450559b360ea0d0091485b","auth":"required","params":[{"_id":"564514506b0ca50d00f6bda8","ref":"","required":false,"desc":"Array of gauge metric datapoint objects","default":"","type":"array_object","name":"gauge"},{"_id":"564517af2229d717001092b7","ref":"","required":false,"desc":"Array of counter metric datapoint objects","default":"","type":"array_object","name":"counter"},{"_id":"564517af2229d717001092b6","ref":"","required":false,"desc":"Array of cumulative counter metric datapoint objects","default":"","type":"array_object","name":"cumulative_counter"}],"url":"/datapoint"},"isReference":false,"order":1,"body":"[block:api-header]\n{\n  \"type\": \"basic\",\n  \"title\": \"Dimension Value Character Limit\"\n}\n[/block]\nA maximum of 1024 characters is allowed for dimension values and metric names. Any datapoint request containing more than 1024 characters will be rejected by SignalFx.","excerpt":"Send metric data points to SignalFx","slug":"datapoint","type":"post","title":"/datapoint"}

post/datapoint

Send metric data points to SignalFx

Definition

{{ api_url }}{{ page_api_url }}

Parameters

gauge:
array of objects
Array of gauge metric datapoint objects
counter:
array of objects
Array of counter metric datapoint objects
cumulative_counter:
array of objects
Array of cumulative counter metric datapoint objects

Examples


Result Format


Documentation

[block:api-header] { "type": "basic", "title": "Dimension Value Character Limit" } [/block] A maximum of 1024 characters is allowed for dimension values and metric names. Any datapoint request containing more than 1024 characters will be rejected by SignalFx.

User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}