Flutter 앱 모니터링

New Relic Flutter 에이전트로 Flutter 애플리케이션을 모니터링하세요. Dart 오류를 캡처하고, 특정 네트워크 요청을 추적하고, 분산 추적을 사용하여 처리된 예외를 드릴다운하고, 사용자 정의 추적 이벤트 및 지표를 생성하여 최종 사용자의 경험을 완전히 캡처하십시오.

Summary view of a flutter app in New Relic

one.newrelic.com > Mobile > (앱 선택) > Summary: Flutter 데이터 보기, HTTP 요청 및 오류 추적, 시간 경과에 따른 앱 성능 모니터링.

시작할 준비가 되셨습니까? 아래 단계를 따르십시오!

Flutter 에이전트 설치

Step 1 of 5

요구 사항 검토

Flutter 에이전트를 설치하기 전에 Flutter 앱이 다음 버전 요구 사항을 충족하는지 확인하세요.

플러터 2.5.0 이상
Dart 버전 2.16.2 이상(3.0.0 이하)
Android 네이티브 앱의 경우:
안드로이드 API 24 이상
Android 기본 요구사항보기
iOS 네이티브 앱의 경우:
iOS 네이티브 요구 사항보기

Step 2 of 5

프로젝트에 Flutter 에이전트 추가

먼저 Flutter 에이전트를 dart 프로젝트에 추가해야 합니다. pubspec.yaml에서 다음을 dependencies에 추가합니다.

dependencies:
    newrelic_mobile: 0.0.1

Step 3 of 5

애플리케이션 토큰 복사

애플리케이션 토큰은 New Relic이 Flutter 앱의 데이터를 인증하는 데 사용됩니다.

New Relic UI에서 애플리케이션 토큰을 보고 복사하려면:

one.newrelic.com으로 이동합니다. Add data클릭한 다음 Mobile클릭합니다.
Flutter 앱을 선택합니다.
Settings > Application 으로 이동하여 표시된 Application token복사합니다.
다음 단계에서 이 애플리케이션 토큰을 추가합니다.

Step 4 of 5

Flutter 프로젝트 구성

Flutter 프로젝트에서 main.dart 열고 다음 코드를 추가합니다.

import 'package:newrelic_mobile/newrelic_mobile.dart';

    var appToken = "";

    if (Platform.isAndroid) {
        appToken = "<android app token>"; // Replace with your application token copied from the New Relic UI. 
    } else if (Platform.isIOS) {
        appToken = "<ios app token>"; // Replace with your application token copied from the New Relic UI. 
    }

    Config config =
        Config(accessToken: appToken,

        //Android Specific
        // Optional: Enable or disable collection of event data.
        analyticsEventEnabled: true,

        // Optional: Enable or disable reporting successful HTTP requests to the MobileRequest event type.
        networkErrorRequestEnabled: true,

        // Optional: Enable or disable reporting network and HTTP request errors to the MobileRequestError event type.
        networkRequestEnabled: true,

        // Optional: Enable or disable crash reporting.
        crashReportingEnabled: true,

        // Optional: Enable or disable interaction tracing. Trace instrumentation still occurs, but no traces are harvested. This will disable default and custom interactions.
        interactionTracingEnabled: true,

        // Optional: Enable or disable capture of HTTP response bodies for HTTP error traces and MobileRequestError events.
        httpResponseBodyCaptureEnabled: true,

        // Optional: Enable or disable agent logging.
        loggingEnabled: true,

        // iOS specific
        // Optional: Enable or disable automatic instrumentation of WebViews
        webViewInstrumentation: true,

        //Optional: Enable or disable Print Statements as Analytics Events
        printStatementAsEventsEnabled : true,

        // Optional: Enable or disable automatic instrumentation of HTTP Request
        httpInstrumentationEnabled:true
        );

    NewrelicMobile.instance.start(config, () {
        runApp(MyApp());
    });

    class MyApp extends StatelessWidget {
    ....

애플리케이션 토큰( 3단계에서 복사)을 위 코드의 appToken = "" 에 붙여넣었는지 확인하세요. Android 기본 앱과 iOS 기본 앱을 모두 모니터링하는 경우 둘 다에 대해 별도의 토큰을 추가해야 합니다.

Step 5 of 5

(Android 전용) Android 앱 구성

Android 네이티브 앱이 있는 경우 Android 앱에서 다음과 같이 변경해야 합니다.

앱의 android/build.gradle 파일에 다음 변경 사항을 추가합니다.

buildscript {
        ...
        repositories {
            ...
            mavenCentral()
        }
        dependencies {
            ...
            classpath "com.newrelic.agent.android:agent-gradle-plugin:${latest_android_version}"
        }
    }

android/app/build.gradle 파일 상단에 newrelic 플러그인을 적용합니다.
```
apply plugin: "com.android.application"
apply plugin: 'newrelic' // <-- add this
```
AndroidManifest.xml 파일에 INTERNET 및 ACCESS_NETWORK_STATE 권한을 추가합니다.
```
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```
그리고 끝났습니다! 5분 이내에 New Relic에서 데이터를 보기 시작해야 합니다.

New Relic에서 Flutter 앱 데이터 보기

Flutter 에이전트가 New Relic으로 데이터를 전송했으므로 이제 New Relic에서 앱 데이터를 볼 차례입니다.

one.newrelic.com > Mobile > (Flutter 앱 선택) > Summary 이동하여 시간 경과에 따른 데이터 요약을 확인합니다.

Flutter 에이전트를 사용하면 크래시 추적, HTTP 요청 및 처리된 예외와 같은 모든 모바일 모니터링 기능에 액세스할 수 있습니다. 자세한 내용은 다음 기능 페이지를 확인하세요.

UI에서 누락된 데이터 문제 해결

UI에서 HTTP 데이터를 찾는 데 문제가 있습니까?

문제

Flutter 에이전트를 설치하고 5분 이상 기다린 후 HTTP errors 및 HTTP requests UI 페이지에 No HTTP data appears .

해결책

5분 이상 기다린 후에도 HTTP 데이터가 표시되지 않으면 Flutter 앱 내에서 HttpOverrides.global 재정의하고 있지 않은지 확인하세요.

Flutter 로그 데이터 쿼리

New Relic은 Flutter 로그를 맞춤 이벤트로 저장합니다. 이 NRQL 쿼리를 사용하여 이러한 로그를 쿼리하고 대시보드를 빌드할 수 있습니다.

SELECT * FROM Mobile Dart Console Events SINCE 30 MINUTES AGO

NRQL 쿼리에 대한 자세한 내용은 NRQL 소개를참조하십시오.

(선택 사항) Flutter 에이전트 계측 사용자 지정

New Relic이 데이터를 수집하고 보고하는 방법을 추가로 사용자 정의하려면 다음 선택적 API 호출을 확인하십시오.

오류 추적 및 리소스 추적을 설정합니다.

NewRelic Mobile Start는 WidgetsFlutterBinding.ensureInitialized호출하므로 NewRelic Mobile Start를 사용하지 않는 경우 NewrelicMobile.instance.startAgent호출하기 전에 이 메서드를 호출해야 합니다.

if (Platform.isAndroid) {
    appToken = AppConfig.androidToken;
} else if (Platform.isIOS) {
    appToken = AppConfig.iOSToken;
}

Config config = Config(
    accessToken: appToken,
    analyticsEventEnabled: true,
    networkErrorRequestEnabled: true,
    networkRequestEnabled: true,
    crashReportingEnabled: true,
    interactionTracingEnabled: true,
    httpResponseBodyCaptureEnabled: true,
    loggingEnabled: true,
    webViewInstrumentation: true,
    printStatementAsEventsEnabled: true,
    httpInstrumentationEnabled:true);

// NewrelicMobile.instance.start(config, () {
//   runApp(MyApp());
// });

runZonedGuarded(() async {
    WidgetsFlutterBinding.ensureInitialized();
    FlutterError.onError = NewrelicMobile.onError;
    await NewrelicMobile.instance.startAgent(config);
    runApp(MyApp());
}, (Object error, StackTrace stackTrace) {
    NewrelicMobile.instance.recordError(error, stackTrace);
});

AppToken은 플랫폼에 따라 다릅니다. Android 및 iOS 앱에 대해 별도의 토큰을 생성해야 합니다.

탐색 이벤트를 추적하려면 NewRelicNavigationObserver 를 MaterialApp, WidgetsApp또는 CupertinoApp에 추가해야 합니다.

import 'package:newrelic_mobile/newrelic_navigation_observer.dart';

//....

MaterialApp(
  navigatorObservers: [
    NewRelicNavigationObserver(),
  ],
  // other parameters
)

각 화면 보기/활동을 추적하는 데 도움이 되도록 routes: 설정에 이름을 추가합니다. 예를 들면 다음과 같습니다.

Widget build(BuildContext context) {
return MaterialApp(
  navigatorObservers: [NewRelicNavigationObserver()],
  routes: {
    'pageone': (context) => Page1Screen(),
    'pagetwo': (context) => Page2Screen(),
    'pagethree': (context) => Page3Screen(),
    'pagefour': (context) => Page4Screen()
  },
  theme: ThemeData(
    primarySwatch: Colors.blue,
    visualDensity: VisualDensity.adaptivePlatformDensity,
  ),
  initialRoute: 'pageone',
);
}

go_router 라이브러리를사용할 때 애플리케이션의 GoRouter.observers에 NewRelicNavigationObserver 인스턴스를 추가하여 자동 라우팅 계측을 사용 설정할 수 있습니다.

//....

import 'package:go_router/go_router.dart';
import 'package:newrelic_mobile/newrelic_navigation_observer.dart';


final router = GoRouter(
    routes: ...,
        observers: [NewRelicNavigationObserver()],
);

다음 방법으로 사용자 정의 속성을 사용하여 심각하지 않은 예외를 수동으로 보고할 수 있습니다.

try {
    some_code_that_throws_error();
} catch (ex) {
NewrelicMobile.instance
        .recordError(error, StackTrace.current, attributes: attributes);
}

iOS 또는 Android SDK API를 사용하여 사용자 지정 이벤트 및 메트릭을 생성합니다. 여기 몇 가지 예가 있어요.

startInteraction(문자열 actionName) 미래

메서드를 상호 작용으로 추적합니다.

InteractionId 문자열입니다.

endInteraction(String interactionId): 무효;

상호 작용을 종료합니다(필수). 종료하려는 상호 작용에 대한 문자열 ID를 사용합니다. 이 문자열은 startInteraction()사용할 때 반환됩니다.

var id = await NewrelicMobile.instance.startInteraction("Getting Data from Service");
            try {
                var dio = Dio();
                var response = await dio.get(
                    'https://reqres.in/api/users?delay=15');
                    print(response);
                NewrelicMobile.instance.endInteraction(id);
                Timeline.finishSync();
            } catch (e) {
                print(e);
            }

[setAttribute] (/docs/mobile-monitoring/new-relic-mobile-ios/ios-sdk-api)(문자열 이름, 동적 값) : void;

여러 모바일 이벤트 유형에서 공유하는 세션 수준 속성을 만듭니다. 이전 값을 덮어쓰고 호출될 때마다 입력합니다.

NewrelicMobile.instance.setAttribute('RNCustomAttrNumber', 37);

setUserId(문자열 사용자 ID): 무효;

사용자 세션을 분석 이벤트 및 속성과 연결하려면 사용자 정의 사용자 식별자 값을 설정하십시오.

NewrelicMobile.instance.setUserId("RN12934");

recordBreadcrum(문자열 이름,'{Map<String, dynamic>? eventAttributes}'): 무효;

충돌 문제를 해결하는 데 도움이 되도록 앱 활동/화면을 추적합니다.

NewrelicMobile.instance.recordBreadcrumb("Button Got Pressed on Screen 3"),

recordCustomEvent(String eventType,'{String eventName = "", Map<String, dynamic>? eventAttributes}'): 무효;

New Relic Insights에서 사용할 사용자 지정 이벤트를 생성하고 기록합니다.

NewrelicMobile.instance.recordCustomEvent("Major",eventName: "User Purchase",eventAttributes: {"item1":"Clothes","price":34.00}),
        child: const Text('Record Custom Event'),

noticeHttpTransaction(String url,String httpMethod,int statusCode,int startTime,int endTime,int bytesSent,int bytesReceived,Map'<String, dynamic>'? traceData,'{String responseBody = ""}''): 무효;

네트워크 요청을 수동으로 추적합니다. 이 메서드를 사용하여 응답 본문을 보내는 옵션을 포함하여 HTTP 트랜잭션을 기록할 수 있습니다.

NewrelicMobile.instance.noticeNetworkFailure("https://cb6b02be-a319-4de5-a3b1-361de2564493.mock.pstmn.io/searchpage", "GET", 1000, 2000,'Test Network Failure', NetworkFailure.dnsLookupFailed);

noticeNetworkFailure(문자열 url,문자열 httpMethod,int startTime,int endTime,NetworkFailure errorCode): 무효;

네트워크 장애를 기록합니다. 네트워크 요청이 실패하면 이 방법을 사용하여 실패에 대한 세부 정보를 기록합니다. 대부분의 경우 이 호출을 catch 블록과 같은 예외 처리기 내부에 배치합니다. 지원되는 실패는 다음과 같습니다.

Unknown
BadURL
TimedOut
CannotConnectToHost
DNSLookupFailed
BadServerResponse

SecureConnectionFailed

NewrelicMobile.instance.noticeNetworkFailure("https://cb6b02be-a319-4de5-a3b1-361de2564493.mock.pstmn.io/searchpage", "GET", 1000, 2000,'Test Network Failure', NetworkFailure.dnsLookupFailed);

recordMetric(문자열 이름, 문자열 범주, int? 값, 문자열? countUnit, 문자열? valueUnit): 무효;

사용자 지정 메트릭(임의의 숫자 데이터)을 기록합니다. 여기서 countUnit은 메트릭 개수의 측정 단위이고 valueUnit은 메트릭 값의 측정 단위입니다. countUnit 또는 valueUnit을 사용하는 경우 value, countUnit 및 valueUnit을 모두 설정해야 합니다.

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

이 한글 문서는 사용자의 편의를 위해 기계 번역되었습니다.

Flutter 에이전트 설치

요구 사항 검토

프로젝트에 Flutter 에이전트 추가

애플리케이션 토큰 복사

Flutter 프로젝트 구성

(Android 전용) Android 앱 구성

New Relic에서 Flutter 앱 데이터 보기

UI에서 누락된 데이터 문제 해결

문제

해결책

Flutter 로그 데이터 쿼리

(선택 사항) Flutter 에이전트 계측 사용자 지정

오류 및 리소스 추적

화면 탐색 이벤트 추적

GoRouter: 자동 라우팅 계측 활성화

수동으로 오류 보고

방법을 상호 작용으로 추적

여러 모바일 이벤트 유형에서 공유하는 세션 수준 속성을 생성합니다.

분석 이벤트 및 속성과 사용자 세션 연결

이동 경로 기록

맞춤 이벤트 기록

최대 이벤트 버퍼 시간 구성

이벤트 풀의 크기 구성

네트워크 요청을 수동으로 추적

네트워크 장애 기록

레코드 메트릭

에이전트 종료