This project has been moved to the following monorepo: robingenz/capacitor-firebase.
@robingenz/capacitor-firebase-performance
Capacitor plugin for Firebase Performance Monitoring.
| Maintainer | GitHub | Social |
|---|---|---|
| Robin Genz | robingenz | @robin_genz |
npm install @robingenz/capacitor-firebase-performance firebase
npx cap syncAdd Firebase to your project if you haven't already (Android / iOS / Web).
See Add the Performance Monitoring plugin to your app and follow the instructions to set up your app correctly.
This plugin will use the following project variables (defined in your app’s variables.gradle file):
$firebasePerfVersionversion ofcom.google.firebase:firebase-perf(default:20.0.5)
No configuration required for this plugin.
A working example can be found here: robingenz/capacitor-firebase-plugin-demo
import { FirebasePerformance } from '@robingenz/capacitor-firebase-performance';
const startTrace = async () => {
await FirebasePerformance.startTrace({ traceName: 'test_trace' });
};
const stopTrace = async () => {
await FirebasePerformance.stopTrace({ traceName: 'test_trace' });
};
const incrementMetric = async () => {
await FirebasePerformance.incrementMetric({
traceName: 'test_trace',
metricName: 'item_cache_hit',
incrementBy: 1
});
};
const setPerformanceCollectionEnabled = async () => {
await FirebasePerformance.setPerformanceCollectionEnabled({ enabled: true });
};
const isPerformanceCollectionEnabled = async () => {
const result = await FirebasePerformance.isPerformanceCollectionEnabled();
return result.enabled;
};startTrace(...)stopTrace(...)incrementMetric(...)setPerformanceCollectionEnabled(...)isPerformanceCollectionEnabled()- Interfaces
startTrace(options: StartTraceOptions) => Promise<void>Starts a trace.
| Param | Type |
|---|---|
options |
StartTraceOptions |
stopTrace(options: StopTraceOptions) => Promise<void>Stops a trace.
| Param | Type |
|---|---|
options |
StopTraceOptions |
incrementMetric(options: IncrementMetricOptions) => Promise<void>Atomically increments the metric with the given name for the selected trace by the incrementBy value.
| Param | Type |
|---|---|
options |
IncrementMetricOptions |
setPerformanceCollectionEnabled(options: SetPerformanceCollectionEnabledOptions) => Promise<void>Enables or disables performance monitoring. Will be applied with the next start of the app.
| Param | Type |
|---|---|
options |
SetPerformanceCollectionEnabledOptions |
isPerformanceCollectionEnabled() => Promise<IsPerformanceCollectionEnabledResult>Determines whether performance monitoring is enabled or disabled.
Returns: Promise<IsPerformanceCollectionEnabledResult>
| Prop | Type | Description |
|---|---|---|
traceName |
string |
Custom trace name. Names for custom code traces must meet the following requirements: no leading or trailing whitespace, no leading underscore (_) character, and max length is 100 characters. |
| Prop | Type | Description |
|---|---|---|
traceName |
string |
Name of the trace that was set with startTrace. |
| Prop | Type | Description |
|---|---|---|
traceName |
string |
Name of the trace that was set with startTrace. |
metricName |
string |
Name of the metric to be incremented. |
incrementBy |
number |
Amount by which the metric has to be incremented. Default: 1 |
| Prop | Type | Description |
|---|---|---|
enabled |
boolean |
Should performance monitoring be enabled. |
| Prop | Type | Description |
|---|---|---|
enabled |
boolean |
true if performance monitoring is enabled, otherwise false. |
See CHANGELOG.md.
See LICENSE.
