Skript-Profilierer

Skript-Profilierer ist ein Tool innerhalb der Entwicklerkonsole, das es Ihnen ermöglicht, Profilierungssitzungen aller laufenden Skripte aufzuzeichnen und deren CPU-Zeitkosten mit benutzerdefinierten Aufzeichnungs- und Anzeigeeinstellungen anzuzeigen. Es kann alle Arten von Funktionsaufrufen aufzeichnen, einschließlich Luau-Funktionen, Methodenaufrufen und Eigenschaftszugriffen. Dieses Tool ist hilfreich, um Skripte zu identifizieren, die die meisten CPU-Ressourcen verbrauchen und die Leistung verlangsamen.

Profilierungssitzungen aufzeichnen

Bevor Sie aufzeichnen, müssen Sie die Aufzeichnungsumgebung auswählen:

• Client (Standard) — Zeichnet clientseitige Skripte auf, einschließlich LocalScripts und Scripts mit RunContext, das auf Client gesetzt ist.
• Server — Zeichnet serverseitige Skripte auf, einschließlich Scripts mit RunContext, das auf Server oder Legacy gesetzt ist. Der Skript-Profilierer löscht alle gesammelten serverseitigen Daten am Ende jeder Sitzung.

Sie können auch die folgenden Aufzeichnungsoptionen festlegen:

Um eine neue Profilierungssitzung aufzuzeichnen:

1. Öffnen Sie die Entwicklerkonsole.

2. Erweitern Sie das Dropdown-Menü für Tools, um Skript-Profilierer auszuwählen.

   

3. Erweitern Sie das Dropdown-Menü für Client-Server, um Client oder Server auszuwählen.

   

4. OPTIONAL

   Aktivieren Sie das Kontrollkästchen Live, um das Live-Abfrageverhalten zu aktivieren.

5. OPTIONAL

   Wählen Sie Frequenz und Zeit, um die Aufzeichnungsfrequenz und die Sitzungsdauer auszuwählen, wenn Sie die Standardwerte nicht verwenden möchten.

6. Klicken Sie auf Start, um die Profilierungssitzung zu beginnen. Wenn Sie eine Dauer festgelegt haben, zeigt der Skript-Profilierer einen Countdown-Timer mit der verbleibenden Zeit in der Sitzung an.

7. Klicken Sie auf Stop oder warten Sie, bis die Aufzeichnung beendet ist, um die Profilierungsdaten anzuzeigen.

Profilierungsdaten lesen

Nachdem eine Sitzung gestoppt wurde, generiert der Skript-Profilierer eine Tabelle, die zeigt, wie viel Zeit jeder Funktionsaufruf in CPU-Zeit kostet. Die Tabelle sortiert die Funktionsaufrufe von den meisten bis zu den wenigsten aufgewendeten Zeiten und ermöglicht es Ihnen, nach bestimmten Funktionen anhand ihres Namens zu suchen. Sie bietet die folgenden zwei Ansichten:

• Callgraph (Standard): Kategorisiert und zeigt Funktionsaufrufe in einer Baumstruktur basierend auf Rahmeneinträgen an. Diese Ansicht zeigt jede Aufgaben-Kategorie als Knoten unter demselben Wurzelknoten an und ermöglicht es Ihnen, sie zu erweitern, um Funktionen anzuzeigen. Sie können auch über jeden Knoten im Baum fahren, um Datei- und Zeileninformationen anzuzeigen. Zum Beispiel könnte Stepped/CameraInput/<anonym> Players.[LocalPlayer].PlayerScripts.PlayerModule.CameraModule.CameraInput:125 offenbaren.
• Funktionen: Listet alle Funktionen auf, ohne sie nach Aufgaben zu kategorisieren.

Sie können auch aus den folgenden Anzeigeoptionen auswählen, um Ihre Debugging-Bedürfnisse anzupassen:

Profilierungsdaten exportieren

Der Skript-Profilierer ermöglicht es Ihnen, aufgezeichnete Profilierungsdaten als JSON-Datei zu exportieren. Um aufgezeichnete Daten nach einer Profilierungssitzung zu exportieren:

1. Klicken Sie im Fenster des Skript-Profilierers auf Exportieren.

2. Wählen Sie im Exportfenster die Profilierungssitzung aus, die Sie exportieren möchten. Benennen Sie den Standarddateinamen um, wenn Sie einen benutzerdefinierten Namen festlegen möchten.

3. Klicken Sie auf Exportieren, um die JSON-Datei zu speichern.

   

Die exportierte JSON-Datei enthält die folgenden Felder:

• Version: Die Versionsnummer.
• SessionStartTime: Ein Zeitstempel in Millisekunden, der die Startzeit der Sitzung aufzeichnet.
• SessionEndTime: Ein Zeitstempel in Millisekunden, der die Endzeit der Sitzung aufzeichnet.
• Categories: Ein Array von Rahmeneintragskategorien, die in der Profilierungssitzung aufgezeichnet wurden. Jeder Eintrag enthält:

  • Name: Der Name jeder Rahmeneintragskategorie.
  • NodeId: Der eindeutige Identifikator einer Aufgaben-Kategorie (Knoten). Es ist ein 1-basierter Index im Nodes-Array. Zum Beispiel können Sie den Knoten mit der NodeId von 123 abrufen, indem Sie das 123. Element in Nodes abrufen.
• Nodes: Ein Array von Knoten, die in der Profilierungssitzung aufgezeichnet wurden. Jeder Eintrag enthält:

  • TotalDuration: Die Zeit, die der Knoten in CPU-Zeit in Mikrosekunden kostet.
  • FunctionIds: Ein Array von eindeutigen Identifikatoren von Funktionen.
  • NodeIds: Ein Array von Knoten-IDs.
• Functions: Ein Array von Funktionen, die in der Profilierungssitzung aufgezeichnet wurden.

  • TotalDuration: Die Zeit, die die Funktion in CPU-Zeit in Mikrosekunden kostet.
  • Name: Der Name der Funktion, falls verfügbar.
  • Source: Die Quelle der Funktion, falls verfügbar.
  • Line: Die Zeilennummer der Funktion, falls verfügbar.
  • Flags: Ein Bitfeld, das eine spezifische Ausführungsumgebung der Funktion angibt. Derzeit kann es die folgenden Werte haben:

    • 0: Das 0. Bit repräsentiert IsNative für die Ausführung unter Native CodeGen.
    • 1: Das 1. Bit repräsentiert IsPlugin für die Ausführung als Teil eines Plugins.

{
  "Version":2,
  "SessionStartTime":1704850750514,
  "SessionEndTime":1704850751198,
  "Categories":
  [
    {"Name":"Parallel Luau","NodeId":4},
    {"Name":"Heartbeat","NodeId":1}
  ],
  "Nodes":
  [
      {"TotalDuration":2530,"FunctionIds":[1],"NodeIds":[2]},
      {"TotalDuration":2530,"FunctionIds":[2,5],"NodeIds":[3,7]},
      {"TotalDuration":1267},
      {"TotalDuration":7746,"FunctionIds":[3],"NodeIds":[5]},
      {"TotalDuration":7746,"FunctionIds":[4],"NodeIds":[6]},
      {"TotalDuration":7746},
      {"TotalDuration":1263,"FunctionIds":[6],"NodeIds":[8]},
      {"TotalDuration":1263,"FunctionIds":[7],"NodeIds":[9]},
      {"TotalDuration":1263,"FunctionIds":[8],"NodeIds":[10]},
      {"TotalDuration":1263}
  ],
  "Functions":
  [
    {"Name":"main","TotalDuration":2530},
    {"Source":"builtin_ManageCollaborators.rbxm.ManageCollaborators.Packages._Index.roblox_rodux-3.0.0.rodux.Store","Line":81,"TotalDuration":1267},
    {"Name":"Skript","TotalDuration":7746},
    {"Source":"Workspace.Actor.Script","Line":1,"TotalDuration":7746},
    {"Source":"builtin_DeveloperInspector.rbxm.DeveloperInspector.Packages._Index.DeveloperFramework.DeveloperFramework.UI.Components.Grid","Line":221,"TotalDuration":1263},
    {"Source":"builtin_DeveloperInspector.rbxm.DeveloperInspector.Packages._Index.DeveloperFramework.DeveloperFramework.UI.Components.Grid","Name":"_update","Line":236,"TotalDuration":1263},
    {"Source":"builtin_DeveloperInspector.rbxm.DeveloperInspector.Packages._Index.DeveloperFramework.DeveloperFramework.UI.Components.Grid","Name":"_getRange","Line":277,"TotalDuration":1263},
    {"Source":"[C]","Name":"ScrollingFrame.CanvasPosition","TotalDuration":1263}
  ]
}