Update api docs

docs/development/core/server/kibana-plugin-core-server.savedobjectsincrementcounteroptions.initialize.md

@@ -0,0 +1,13 @@
+<!-- Do not edit this file. It is automatically generated by API Documenter. -->
+
+[Home](./index.md) &gt; [kibana-plugin-core-server](./kibana-plugin-core-server.md) &gt; [SavedObjectsIncrementCounterOptions](./kibana-plugin-core-server.savedobjectsincrementcounteroptions.md) &gt; [initialize](./kibana-plugin-core-server.savedobjectsincrementcounteroptions.initialize.md)
+
+## SavedObjectsIncrementCounterOptions.initialize property
+
+Sets all the counter fields to 0 if they don't already exist
+
+<b>Signature:</b>
+
+```typescript
+initialize?: boolean;
+```

docs/development/core/server/kibana-plugin-core-server.savedobjectsincrementcounteroptions.md

@@ -15,6 +15,7 @@ export interface SavedObjectsIncrementCounterOptions extends SavedObjectsBaseOpt
 
 |  Property | Type | Description |
 |  --- | --- | --- |
+|  [initialize](./kibana-plugin-core-server.savedobjectsincrementcounteroptions.initialize.md) | <code>boolean</code> | Sets all the counter fields to 0 if they don't already exist |
 |  [migrationVersion](./kibana-plugin-core-server.savedobjectsincrementcounteroptions.migrationversion.md) | <code>SavedObjectsMigrationVersion</code> |  |
 |  [refresh](./kibana-plugin-core-server.savedobjectsincrementcounteroptions.refresh.md) | <code>MutatingOperationRefreshSetting</code> | The Elasticsearch Refresh setting for this operation |
 

docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.incrementcounter.md

@@ -29,25 +29,19 @@ incrementCounter(type: string, id: string, counterFieldNames: string[], options?
 
 ## Remarks
 
-When supplying a field name like `stats.api.counter` the field name will be used as-is to create a document like: `{attributes: {'stats.api.counter': 1}}` It will not create a nested structure like: `{attributes: {stats: {api: {counter: 1}}}}`
+\* When supplying a field name like `stats.api.counter` the field name will be used as-is to create a document like: `{attributes: {'stats.api.counter': 1}}` It will not create a nested structure like: `{attributes: {stats: {api: {counter: 1}}}}` When using incrementCounter for collecting usage data, you need to ensure that usage collection happens on a best-effort basis and doesn't negatively affect your plugin or users. See https://github.com/elastic/kibana/blob/master/src/plugins/usage\_collection/README.md\#tracking-interactions-with-incrementcounter)
 
 ## Example
 
-Collecting usage data
 
 ```ts
 const repository = coreStart.savedObjects.createInternalRepository();
 
-// NOTE: Usage collection happens on a best-effort basis, so we don't
-// `await` the promise returned by `incrementCounter` and we swallow any
-// exceptions in production.
 repository
-  .incrementCounter('test_counter_type', 'counter_2', [
-    'stats.api.count',
-    'stats.api.count2',
-    'stats.total',
+  .incrementCounter('dashboard_counter_type', 'counter_id', [
+    'stats.apiCalls',
+    'stats.sampleDataInstalled',
   ])
-  .catch((e) => (coreContext.env.cliArgs.dev ? logger.error(e) : e));
 
 ```
 

src/core/server/server.api.md

@@ -2366,6 +2366,7 @@ export interface SavedObjectsImportUnsupportedTypeError {
 
 // @public (undocumented)
 export interface SavedObjectsIncrementCounterOptions extends SavedObjectsBaseOptions {
+    initialize?: boolean;
     // (undocumented)
     migrationVersion?: SavedObjectsMigrationVersion;
     refresh?: MutatingOperationRefreshSetting;