TSRECORDS(3ts)

💖 TRAFFIC SERVER RECORDS(3ts) 💖

okay bestie, sit down, hydrate, and let me tell you about the Traffic Server Records — this is part of Apache Traffic Server's manual, and it's genuinely iconic. Traffic Server keeps a whole set of records, and those records cover both configuration values AND statistics. yes. both. one big happy family. 🫶

---

✨ NAME ✨

Traffic Server Records — traffic Server maintains a set of records which cover both configuration values and statistics 💅

---

🌸 SYNOPSIS 🌸

#include <ts/ts.h>

TSReturnCode TSMgmtStringCreate(TSRecordType rec_type, const char *name,
const TSMgmtString data_default, TSRecordUpdateType update_type,
TSRecordCheckType check_type, const char *check_regex,
TSRecordAccessType access_type)

TSReturnCode TSMgmtIntCreate(TSRecordType rec_type, const char *name,
const TSMgmtInt data_default, TSRecordUpdateType update_type,
TSRecordCheckType check_type, const char *check_regex,
TSRecordAccessType access_type)

---

🎀 DESCRIPTION 🎀

so, TSMgmtStringCreate() registers name as a configuration name and sets all its various properties. it's giving "official registration, no notes". ✨

and listen — if check_type is TS_RECORDCHECK_STR, then check_reg must point to a valid regular expression, because that regex is what gets used to check the string value. no regex, no vibes, it's a whole requirement. 🧚

🚨 okay this next part is the IMPORTANT one, fr fr. If a plugin uses a value from records.config that is not built in to Traffic Server, it must use this function — otherwise that value will be inaccessible and a warning for that name will be generated. so like… use the function. don't be the warning. 😭

---

👑 RETURN VALUES 👑

TSMgmtStringCreate() and TSMgmtIntCreate() return TS_SUCCESS if the management value was created, and TS_ERROR if not. that's it, that's the whole vibe check. 💀

---

🔥 SEE ALSO 🔥

• TSAPI(3ts)

---

🌈 COPYRIGHT 🌈

2026, dev@trafficserver.apache.org 💜

---

and that's the whole page, bestie — this one shipped as version 9.2 on Feb 12, 2026. go forth and register your records, you absolute main character. 👑💖🦋