Enregistrer des métriques personnalisées

Syntaxe

Objectif-C

[NewRelic recordMetricWithName:(NSString *)name  category:(NSString *)category  value:(NSNumber *)value];

Swift [#swift]

NewRelic.recordMetric(withName: String!, category: String!, value: NSNumber!)

Description [#description]

Avec cette méthode, vous pouvez enregistrer des métriques personnalisées arbitraires pour donner plus de détails sur l'activité de l'application qui n'est pas suivie automatiquement par New Relic. L'appel accepte plusieurs ensembles de paramètres pour des niveaux de détail optionnels.

Cette méthode enregistrera une métrique de la forme Custom/[Category]/[Name], avec un compte de 1 et une valeur totale égale à la valeur transmise. Plusieurs appels regrouperont le nombre et la valeur selon les règles d'agrégation métrique standard pour monitoring d'applications mobiles.

Pour tirer le meilleur parti de vos métriques, suivez ces directives pour créer des noms de métriques clairs et concis :

• Utilisez les caractères de cas et d'espacement appropriés pour l'affichage dans l'interface utilisateur. les noms métriques sont rendus tels quels.
• Mettez le nom de la métrique en majuscule.
• Évitez d’utiliser les caractères / ] [ | * lorsque vous nommez des métriques.
• Évitez les caractères multi-octets.

Le category est également obligatoire ; il est affiché dans l'interface utilisateur et est utile pour organiser les métriques personnalisées si vous en avez beaucoup. Il peut s'agir d'une catégorie personnalisée ou d'une catégorie prédéfinie utilisant l'énumération MetricCategory .

Paramètres [#parameters]

Exemples [#examples]

Objective-C [#obj-c]

Voici un exemple de création d’une métrique en millisecondes :

[NewRelic recordMetricWithName:(NSString *)@"My Important Metric"
                      category:(NSString *)@"Important Metrics" 
                         value:(NSNumber *)145.67];

Swift [#swift]

Voici un exemple de création d’une métrique en millisecondes :

NewRelic.recordMetric(withName: "My Important Metric", category: "Important Metrics", value: 145.67)

Syntaxe

recordMetric(options: { name: string; category: string; value?: number; countUnit?: string; valueUnit?: string; }) => void

Description [#description]

Enregistrements métriques personnalisés (données numériques arbitraires), où countUnit est l'unité de mesure du nombre métrique et valueUnit est l'unité de mesure de la valeur métrique. Si vous utilisez countUnit ou valueUnit, vous devez définir les trois : value, countUnit et valueUnit.

Les mesures prises en charge pour countUnit et valueUnit sont :

• PERCENT
• BYTES
• SECONDS
• BYTES_PER_SECOND
• OPERATIONS

Paramètres [#parameters]

Exemple [#example]

NewRelicCapacitorPlugin.recordMetric({
  name: "CapacitorMetricName",
  category: "CapacitorMetricCategory",
});
NewRelicCapacitorPlugin.recordMetric({
  name: "CapacitorMetricName2",
  category: "CapacitorMetricCategory2",
  value: 25,
});
NewRelicCapacitorPlugin.recordMetric({
  name: "CapacitorMetricName3",
  category: "CapacitorMetricCategory3",
  value: 30,
  countUnit: NREnums.MetricUnit.SECONDS,
  valueUnit: NREnums.MetricUnit.OPERATIONS,
});

Syntaxe

recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;

Description [#description]

Enregistrements métriques personnalisés (données numériques arbitraires), où countUnit est l'unité de mesure du nombre métrique et valueUnit est l'unité de mesure de la valeur métrique. Si vous utilisez countUnit ou valueUnit, vous devez définir les trois : value, countUnit et valueUnit.

Les mesures prises en charge pour countUnit et valueUnit sont :

• PERCENT
• BYTES
• SECONDS
• BYTES_PER_SECOND
• OPERATIONS

Paramètres [#parameters]

Exemple [#example]

NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory');
NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory', 12);
NewRelic.recordMetric('CordovaCustomMetricName', 'CordovaCustomMetricCategory', 13, 'PERCENT', 'SECONDS');

Syntaxe

RecordMetric(string name, string category) : void;
RecordMetric(string name, string category, double value) : void;

Description [#description]

Enregistrements métriques personnalisés (données numériques arbitraires), où countUnit est l'unité de mesure du nombre métrique et valueUnit est l'unité de mesure de la valeur métrique. Si vous utilisez countUnit ou valueUnit, vous devez définir les trois : value, countUnit et valueUnit.

Les mesures prises en charge pour countUnit et valueUnit sont :

• PERCENT
• BYTES
• SECONDS
• BYTES_PER_SECOND
• OPERATIONS

Paramètres [#parameters]

Exemple [#example]

CrossNewRelic.Current.RecordMetric("Agent start", "Lifecycle");
CrossNewRelic.Current.RecordMetric("Login Auth Metric", "Network", 78.9);

Syntaxe

recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;

Description [#description]

Enregistrements métriques personnalisés (données numériques arbitraires), où countUnit est l'unité de mesure du nombre métrique et valueUnit est l'unité de mesure de la valeur métrique. Si vous utilisez countUnit ou valueUnit, vous devez définir les trois : value, countUnit et valueUnit.

Les mesures prises en charge pour countUnit et valueUnit sont :

• PERCENT
• BYTES
• SECONDS
• BYTES_PER_SECOND
• OPERATIONS

Paramètres [#parameters]

Exemple [#example]

NewrelicMobile.instance.recordMetric("testMetric", "Test Champ",value: 12.0);
NewrelicMobile.instance.recordMetric("testMetric1", "TestChamp12",value: 10,valueUnit: MetricUnit.BYTES,countUnit: MetricUnit.PERCENT);

Syntaxe

recordMetric(name: string, category: string, value?: number, countUnit?: string, valueUnit?: string): void;

Description [#description]

Enregistrements métriques personnalisés (données numériques arbitraires), où countUnit est l'unité de mesure du nombre métrique et valueUnit est l'unité de mesure de la valeur métrique. Si vous utilisez countUnit ou valueUnit, vous devez définir les trois : value, countUnit et valueUnit.

Les mesures prises en charge pour countUnit et valueUnit sont :

• PERCENT
• BYTES
• SECONDS
• BYTES_PER_SECOND
• OPERATIONS

Paramètres [#parameters]

Exemple [#example]

NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory');
NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory', 12);
NewRelic.recordMetric('RNCustomMetricName', 'RNCustomMetricCategory', 13, NewRelic.MetricUnit.PERCENT, NewRelic.MetricUnit.SECONDS);

Syntaxe

RecordMetricWithName(string name, string category) : void;
RecordMetricWithName(string name, string category, double value) : void;
RecordMetricWithName(string name, string category, double value, MetricUnit countUnit, MetricUnit valueUnit) : void;

Description [#description]

Enregistrements métriques personnalisés (données numériques arbitraires), où countUnit est l'unité de mesure du nombre métrique et valueUnit est l'unité de mesure de la valeur métrique. Si vous utilisez countUnit ou valueUnit, vous devez définir les trois : value, countUnit et valueUnit.

Les mesures prises en charge pour countUnit et valueUnit sont :

• PERCENT
• BYTES
• SECONDS
• BYTES_PER_SECOND
• OPERATIONS

Paramètres [#parameters]

Exemple [#example]

NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory');
NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory', 12);
NewRelicAgent.RecordMetricWithName('UnityCustomMetricName', 'UnityCustomMetricCategory', 13, NewRelicAgent.MetricUnit.PERCENT, NewRelicAgent.MetricUnit.SECONDS);

Syntaxe

RecordMetric(string name, string category) : void;
RecordMetric(string name, string category, double value) : void;
RecordMetric(string name, string category, double value, MetricUnit countUnit, MetricUnit valueUnit) : void;

Description [#description]

Enregistrements métriques personnalisés (données numériques arbitraires), où countUnit est l'unité de mesure du nombre métrique et valueUnit est l'unité de mesure de la valeur métrique. Si vous utilisez countUnit ou valueUnit, vous devez définir les trois : value, countUnit et valueUnit.

Les mesures prises en charge pour countUnit et valueUnit sont :

• PERCENT
• BYTES
• SECONDS
• BYTES_PER_SECOND
• OPERATIONS

Paramètres [#parameters]

Exemple [#example]

CrossNewRelicClient.Current.RecordMetric("Agent start", "Lifecycle");
CrossNewRelicClient.Current.RecordMetric("Login Auth Metric", "Network", 78.9);
CrossNewRelicClient.Current.RecordMetric("Request Metric", "Network", 20, MetricUnit.SECONDS, MetricUnit.OPERATIONS);