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