Freigeben über

Bewährte Methoden für die Integration

Azure DevOps Services

Tools und Integrationen zwischen Diensten verbessern die Effizienz für Azure DevOps Services. Wenn Sie nicht vorsichtig sind, können automatisierte Tools aus der Kontrolle geraten und eine hohe Anzahl von Anforderungen ausführen. Die Anforderungen können dazu führen, dass Azure DevOps Ratenbeschränkungen für Ihre Organisation erzwingt. Befolgen Sie diese bewährten Methoden, wenn Sie die REST-APIs für die Integration in Azure DevOps verwenden, um das Risiko von Trefferratenlimits zu verringern.

Nur umsetzbare Arbeitsaufgaben übertragen

Pushen Sie nur umsetzbare Elemente in Azure DevOps, die Ihr Team in Zukunft angehen oder bearbeiten möchte. Halten Sie Arbeitselemente aus Azure DevOps heraus, bis sie notwendig sind. Versuchen Sie beispielsweise nicht, Telemetriedaten in Azure DevOps zu speichern.

Verwalten Ihres eigenen Datenspeichers

Fügen Sie in Azure DevOps keine Arbeitsaufgaben hinzu, um sie an einem zentralen Ort zu haben. Azure DevOps Services ist nicht als Datenspeicherdienst konzipiert. Verwalten Sie Ihren eigenen Datenspeicher.

Änderungen zusammenfassen

Das Ausführen einzelner Vorgänge ist langsam und teuer, was die führende Ursache für Leistungsprobleme und die Begrenzung der Rate ist. Fassen Sie Ihre Änderungen in einem einzigen Aufruf zusammen. Weitere Informationen finden Sie in unserer Batchdokumentation und im Beispielcode.

Beschränken Sie Ihre Überarbeitungen

Viele Überarbeitungen für eine einzelne Arbeitsaufgabe erzeugen eine Aufgeblähung und verursachen Leistungsprobleme. Es wird empfohlen, die folgenden Aufgaben auszuführen:

  • Reduzieren Sie Ihre Aktualisierungen, indem Sie Feldänderungen bündeln. Aktualisieren Sie nicht nur ein Feld gleichzeitig.
  • Wenn Sie Änderungen an mehreren Arbeitsaufgaben haben, fassen Sie diese Änderungen in einer einzigen Aktion zusammen.
  • Halten Sie die Anzahl der Überarbeitungen auf ein Minimum, um Überarbeitungsgrenzwerte zu vermeiden.

Hinweis

Eine Überarbeitungsgrenze für Arbeitsaufgaben von 10.000 ist für Aktualisierungen über die REST-API wirksam. Dieser Grenzwert schränkt Updates aus der REST-API ein, aber Updates aus dem Webportal sind nicht betroffen.

Optimieren von Abfragen

Optimieren Sie Ihre Abfragen, um eine geringe Anzahl von Ergebnissen zurückzugeben. Komplexe Bedingungen und Filter können zu zeitintensiven Abfragen führen. Halten Sie die Ausführungszeit Ihrer Abfrage unter 30 Sekunden, um Schwellenwertfehler zu vermeiden.

Tipps zur Abfrageleistung

  • Platzieren Sie nach Möglichkeit eine Datums- oder Bereichsbeschränkungsklausel am Anfang einer Abfrage.
  • Verringern Sie die Anzahl der Klauseln, die den Ever Operator verwenden.
  • Verringern Sie die Anzahl der Klauseln, die den Contains Operator verwenden, mit Ausnahme von Tags.
    • Verwenden Sie den Contains Words Operator, wenn verfügbar.
    • Verwenden Sie den Contains Operator nicht für lange Textfelder, da es teuer ist.
  • Vermeiden Sie die <>- und Not-Operatoren, wenn möglich.
  • Vermeiden Sie die Verwendung des In Group Operators für große Gruppen.
  • Minimieren Sie die Anzahl der Or-Operatoren und vergewissern Sie sich, dass Sie immer noch Zugriff auf Bereiche oberster Ebene haben, bevor Sie ihn verwenden.
  • Vermeiden Sie die Verwendung einer OR-Klausel zwischen einem In Group-Operator und Flächen- oder Iterationspfaden.
  • Verringern Sie die Anzahl der Allgemeinen Klauseln, um Ihr Ziel nach Möglichkeit zu erreichen.
  • Vermeiden Sie es nach Möglichkeit, nach anderen Elementen als Kernfeldern, wie z.B. ID, zu sortieren.
  • Verwenden Sie ein benutzerdefiniertes Feld in Ihren Filtern, wenn Sie nach einem benutzerdefinierten Feld sortieren möchten.
  • Geben Sie nach Möglichkeit ein Projekt an. Andernfalls wird der Bereich der Abfrage auf die gesamte Sammlung festgelegt und kann erheblich länger dauern, als es erforderlich ist. Deaktivieren Sie " Abfrage über Projekte " in der oberen rechten Ecke des Abfrage-Editors.

Projektübergreifende Abfrage

  • Geben Sie an, welches Projekt Sie suchen, wenn für die Abfrage eine Suche über Projekte erforderlich ist.
  • Verwenden Sie Tags anstelle von Schlüsselwörtern , es sei denn, Sie suchen nach Teiltext einer Zeichenfolge.

Fehler geschickt bewältigen

Aktualisierungen und Abfragen schlagen fehl, wenn ressourcenlimits oder die Nutzungshäufigkeit den Grenzwert überschreitet. Eine Abfrage, die länger als 30 Sekunden ausgeführt wird, gibt beispielsweise den folgenden Fehler zurück:

VS402335: The timeout period (30 seconds) elapsed prior to completion of the query or the server is not responding.

Wenn Sie die REST-APIs verwenden, stellen Sie sicher, dass Sie Ihren Code so entwerfen, dass Fehler ordnungsgemäß behandelt werden.

Beschränken Sie die Anzahl der Links pro Arbeitsaufgabe so weit wie möglich, um die Erzwingung von Verknüpfungsgrenzwerten zu vermeiden.

Von Bedeutung

Wir planen die Erzwingung von Überarbeitungen und Verknüpfungsgrenzwerten für Arbeitsaufgaben in Kürze. Diese Grenzwerte werden durch Leistungsüberwachung und Kundenfeedback bestimmt.

Verwenden Sie keine Abfragen für die Berichterstellung.

Abfragen und einzelne Arbeitselement abrufen sind die beste Methode, um Tarifgrenzen in Ihrer Organisation durchzusetzen. Führen Sie keine Abfragen aus, um große Listen von Arbeitsaufgaben zurückzugeben. Verwenden Sie stattdessen die REST-APIs Arbeitselement-Links und Arbeitselement-Revisionen zum Reporting.

Weitere Informationen finden Sie in unserem C#-Beispiel auf GitHub.

Verwandte Inhalte

  • Last updated on