macOS アプリケーションの接続¶
Guance アプリケーションモニタリングは、各 macOS アプリケーションのメトリクスデータを収集し、各 macOS アプリケーション側のパフォーマンスを可視化して分析できます。
参照順序¶
- 初めて接続する場合:まず接続方法を選択してください。手動接続についてはクイックスタートを参照してください
- 完全な接続:このドキュメントを引き続きお読みください
- 初期化パラメータ:SDK 初期化、RUM 設定、Log 設定、Trace 設定を参照してください
- カスタマイズ機能:カスタムタグの使用、データ収集のカスタムルールを参照してください
- データモデル:アプリケーションデータ収集を参照してください
- トラブルシューティング:トラブルシューティングを参照してください
前提条件¶
注意
RUM Headless サービスを有効化している場合、前提条件は自動的に設定されるため、アプリケーションに直接接続できます。
ローカル環境でデプロイする場合は、以下のデータ受信側の設定を完了する必要があります。パブリックネットワークの DataWay を使用する場合、DataKit を自分でデプロイする必要はありません。
アプリケーションの接続¶
- RUM > アプリケーションを作成 > macOS に移動します
- アプリケーション名を入力します
- アプリケーション ID を入力します
- 「接続方法を選択」で Agent 自動接続または手動接続を選択し、「接続設定」を完了します
接続方法を選択¶
アプリケーション設定ページで「Agent 自動接続」または「手動接続」を選択し、「接続設定」を完了します。既存のアプリケーションの場合は、設定ページに直接移動して接続を続行できます。
| 接続方法 | ユースケース | 操作入口 |
|---|---|---|
| Agent 自動接続 | コーディングアシスタントにプロジェクトを分析させ、SDK の接続を完了させたい場合 | コンソールで生成されたプロンプトをコピーし、アプリケーションのコードリポジトリでコーディングアシスタントに渡して実行します |
| 手動接続 | SDK を自分でインストールしてパラメータを設定したい場合 | データ送信方法を確認し、本文とクイックスタートに従って設定を完了します |
Agent 自動接続¶
- 現在のアプリケーションの設定ページで「Agent 自動接続」を選択します。
- 「接続設定」内のプロンプト全体をコピーします。現在のアプリケーションの接続情報が使用されていることを確認してください。
- アプリケーションのコードリポジトリでコーディングアシスタントを開き、プロンプトを貼り付けます。Agent が接続ガイドに従ってプロジェクトを分析し、SDK の設定を完了します。
- アプリケーションをビルドして実行し、ページアクセスなどの操作を発生させ、現在のアプリケーションのエクスプローラーでデータが受信されていることを確認します。
ページに個人用 API Key または一時認証コードが未準備である旨が表示された場合は、案内に従って補完してからプロンプトを再度コピーしてください。
手動接続¶
アプリケーション設定ページで「手動接続」を選択し、データ送信方法を確認します。
- パブリックネットワーク DataWay:RUM データを直接受信します。DataKit コレクターをインストールする必要はありません。
- ローカル環境デプロイ:前提条件を満たしたうえで RUM データを受信します。
後述のインストールとクイックスタートに従って、SDK のインストール、初期化、検証を完了してください。既存の SDK 設定がある場合は、まず内容を確認して再利用し、重複した初期化を避けてください。
インストール¶
ソースコード:https://github.com/GuanceCloud/datakit-macos
Demo:https://github.com/GuanceCloud/datakit-macos/Example
Podfileファイルを設定します。
Podfileのディレクトリでpod installを実行して SDK をインストールします。
-
PROJECT->Package Dependencyを選択し、Packages欄の + をクリックします。 -
表示されたページの検索ボックスに
https://github.com/GuanceCloud/datakit-macosを入力します。これはコードの保存場所です。 -
Xcode がパッケージの取得に成功すると、SDK の設定ページが表示されます。
Dependency Rule:Up to Next Major Version を選択することを推奨します。
Add To Project:サポート対象のプロジェクトを選択します。
設定を入力したら Add Package ボタンをクリックし、読み込みが完了するまで待ちます。
Choose Package Products for datakit-macosダイアログで SDK を追加する Target を選択し、Add Packageボタンをクリックすると、SDK の追加が完了します。
プロジェクトが SPM で管理されている場合は、FTMacOSSDK を依存関係として追加し、dependencies を Package.swift に追加します。
```swift dependencies: [
.package(url: "https://github.com/GuanceCloud/datakit-macos.git", .upToNextMajor(from: "[latest_version]")) ] ```
ヘッダーファイルの追加¶
詳細設定の入口¶
高度なシナリオ¶
よくある質問¶
クラッシュログの分析について¶
クラッシュログの分析と dSYM の説明については、トラブルシューティングを参照してください。
「Include of non-modular header inside framework module」エラーが発生する¶
SDK の .h ファイルで依存ライブラリの .h ファイルをインクルードしているため、次の設定が必要です。
Target -> Build Settings -> CLANG_ALLOW_NON_MODULAR_INCLUDES_IN_FRAMEWORK_MODULES を YES に設定します。