1# 应用事件打点错误码 2 3> **说明：** 4> 5> 以下仅介绍本模块特有错误码，通用错误码请参考[通用错误码说明文档](../errorcode-universal.md)。 6 7## 11100001 打点功能被关闭 8 9**错误信息** 10 11Function disabled. 12 13**错误描述** 14 15- 在调用write接口进行应用事件打点时，由于打点功能未开启，系统将忽略相关事件。 16- 在调用setEventParam接口设置事件自定义参数时，由于打点功能未开启，系统将忽略此次调用。 17 18**可能原因** 19 20应用事件打点功能被关闭了。 21 22**处理步骤** 23 24调用配置接口开启打点功能。 25 26 ```ts 27 import hiAppEvent from '@ohos.hiviewdfx.hiAppEvent'; 28 29 hiAppEvent.configure({ 30 disable: false 31 }); 32 ``` 33 34## 11101001 非法的事件领域名称 35**错误信息** 36 37Invalid event domain. 38 39**错误描述** 40 41- 在调用write接口进行应用事件打点时，由于传入了非法的事件领域名称，系统将忽略相关事件。 42- 在调用setEventParam接口设置事件自定义参数时，由于传入了非法的事件领域名称，系统将忽略此次调用。 43 44**可能原因** 45 46传入的事件领域名称不符合以下规则： 47 48- 事件领域名称只包含数字、字母、下划线字符。 49- 事件领域名称以字母开头，不以下划线结尾。 50- 事件领域名称非空且长度不超过32个字符。 51 52**处理步骤** 53 54传入合法的事件领域名称。 55 56## 11101002 非法的事件名称 57 58**错误信息** 59 60Invalid event name. 61 62**错误描述** 63 64- 在调用write接口进行应用事件打点时，由于传入了非法的事件名称，系统将忽略相关事件。 65- 在调用setEventParam接口设置事件自定义参数时，由于传入了非法的事件名称，系统将忽略此次调用。 66 67**可能原因** 68 69传入的事件名称不符合以下规则： 70 71- 事件名称只包含$字符、数字字符、字母字符、下划线字符。 72- 事件名称首字符必须为字母字符或$字符，中间字符必须为数字字符、字母字符或下划线字符，结尾字符必须为数字字符或字母字符。 73- 事件名称非空且长度不超过48个字符。 74 75**处理步骤** 76 77传入合法的事件名称。 78 79## 11101003 非法的事件参数数量 80 81**错误信息** 82 83Invalid number of event parameters. 84 85**错误描述** 86 87在调用write接口进行应用事件打点时，由于传入了非法的事件参数数量，额外的事件参数将被丢弃。 88 89**可能原因** 90 91传入的事件参数数量超过32个。 92 93**处理步骤** 94 95传入合法数量的事件参数。 96 97## 11101004 非法的事件参数字符串长度 98 99**错误信息** 100 101Invalid string length of the event parameter. 102 103**错误描述** 104 105- 在调用write接口进行应用事件打点时，由于事件参数值传入了超长的字符串，系统将忽略相关事件参数。 106- 在调用setEventParam接口设置事件自定义参数时，由于传入了非法的事件参数值，系统将忽略此次调用。 107 108**可能原因** 109 110- 调用write接口传入的事件参数值中的字符串长度超过8*1024个字符。 111- 调用setEventParam接口传入的事件自定义参数值的长度超过1024个字符。 112 113**处理步骤** 114 115传入合法字符串长度的事件参数值。 116 117## 11101005 非法的事件参数名称 118 119**错误信息** 120 121Invalid event parameter name. 122 123**错误描述** 124 125- 在调用write接口进行应用事件打点时，由于传入了非法的事件参数名称，系统将忽略相关事件参数。 126- 在调用setEventParam接口设置事件自定义参数时，由于传入了非法的事件参数名称，系统将忽略此次调用。 127 128**可能原因** 129 130传入的事件参数名称不符合以下规则： 131 132- 事件参数名称只包含$字符、数字字符、字母字符、下划线字符。 133- 事件参数名称首字符必须为字母字符或$字符，中间字符必须为数字字符、字母字符或下划线字符，结尾字符必须为数字字符或字母字符。 134- 事件参数名称非空且长度不超过32个字符。 135 136**处理步骤** 137 138传入合法的事件参数名称。 139 140## 11101006 非法的事件参数数组长度 141 142**错误信息** 143 144Invalid array length of the event parameter. 145 146**错误描述** 147 148在调用write接口进行应用事件打点时，由于事件参数值传入了超出长度的数组，额外的数组元素将被丢弃。 149 150**可能原因** 151 152传入的事件参数值中的数组长度超过100。 153 154**处理步骤** 155 156传入合法长度数组的事件参数值。 157 158## 11101007 非法的事件自定义参数数量 159 160**错误信息** 161 162The number of parameter keys exceeds the limit. 163 164**错误描述** 165 166在调用setEventParam接口设置事件自定义参数时，由于传入了非法的事件参数数量，系统将忽略此次调用。 167 168**可能原因** 169 170传入的事件自定义参数数量超过64个。 171 172**处理步骤** 173 174传入合法数量的事件自定义参数。 175 176## 11102001 非法的观察者名称 177 178**错误信息** 179 180Invalid watcher name. 181 182**错误描述** 183 184在调用addWatcher接口进行事件订阅时，由于传入了非法的观察者名称，系统将忽略此次订阅。 185 186**可能原因** 187 188传入的观察者名称不符合以下规则： 189 190- 观察者名称只包含数字、字母、下划线字符。 191- 观察者名称以字母开头，不以下划线结尾。 192- 观察者名称非空且长度不超过32个字符。 193 194**处理步骤** 195 196传入合法的观察者名称。 197 198## 11102002 非法的过滤事件领域 199 200**错误信息** 201 202Invalid filtering event domain. 203 204**错误描述** 205 206在调用addWatcher接口进行事件订阅时，由于传入了非法的过滤事件领域，系统将忽略此次订阅。 207 208**可能原因** 209 210传入的过滤事件领域名称不符合以下规则： 211 212- 事件领域名称只包含数字、字母、下划线字符。 213- 事件领域名称以字母开头，不以下划线结尾。 214- 事件领域名称非空且长度不超过32个字符。 215 216**处理步骤** 217 218传入合法的过滤事件领域名称。 219 220## 11102003 非法的条数值 221 222**错误信息** 223 224Invalid row value. 225 226**错误描述** 227 228在调用addWatcher接口进行事件订阅时，由于回调触发条件传入了非法的事件个数值，系统将忽略此次订阅。 229 230**可能原因** 231 232传入的回调触发条件中的条数值为负数。 233 234**处理步骤** 235 236传入自然数值的条数值。 237 238## 11102004 非法的大小值 239 240**错误信息** 241 242Invalid size value. 243 244**错误描述** 245 246在调用addWatcher接口进行事件订阅时，由于回调触发条件传入了非法的事件大小值，系统将忽略此次订阅。 247 248**可能原因** 249 250传入的回调触发条件中的大小值为负数。 251 252**处理步骤** 253 254传入自然数值的大小值。 255 256## 11102005 非法的超时值 257 258**错误信息** 259 260Invalid timeout value. 261 262**错误描述** 263 264在调用addWatcher接口进行事件订阅时，由于回调触发条件传入了非法的超时值，系统将忽略此次订阅。 265 266**可能原因** 267 268传入的回调触发条件中的超时值为负数。 269 270**处理步骤** 271 272传入自然数值的超时值。 273 274## 11103001 非法的最大存储配额值 275 276**错误信息** 277 278Invalid max storage quota value. 279 280**错误描述** 281 282在调用configure接口进行打点配置时，由于传入了非法的最大存储配额值，系统将忽略此次配置。 283 284**可能原因** 285 286传入的最大存储配额值字符串不符合以下规则： 287 288- 配额值字符串只由数字字符和大小单位字符（单位字符支持[b|k|kb|m|mb|g|gb|t|tb]，不区分大小写）构成。 289- 配额值字符串必须以数字开头，后面可以选择不传单位字符（默认使用byte作为单位），或者以单位字符结尾。 290 291**处理步骤** 292 293传入合法的最大存储配额值字符串。 294 295## 11104001 非法的事件包大小值 296 297**错误信息** 298 299Invalid size value. 300 301**错误描述** 302 303在调用setSize接口对每次取出的事件包大小阈值进行设置时，由于传入了非法的事件包大小值，系统将忽略此次设置。 304 305**可能原因** 306 307传入的事件包大小值为负数。 308 309**处理步骤** 310 311传入自然数值的事件包大小。