Skip to content

Commit 75eb6cc

Browse files
zeripathzeripath
authored
Improve SyncMirrors logging (#19045)
Yet another issue has come up where the logging from SyncMirrors does not provide enough context. This PR adds more context to these logging events. Related #19038 Signed-off-by: Andrew Thornton <[email protected]>
1 parent 1314f38 commit 75eb6cc

File tree

4 files changed

+57
-43
lines changed

4 files changed

+57
-43
lines changed

‎models/lfs.go

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -193,12 +193,13 @@ func LFSAutoAssociate(metas []*LFSMetaObject, user *user_model.User, repoID int6
193193
// admin can associate any LFS object to any repository, and we do not care about errors (eg: duplicated unique key),
194194
// even if error occurs, it won't hurt users and won't make things worse
195195
for i := range metas {
196+
p := lfs.Pointer{Oid: metas[i].Oid, Size: metas[i].Size}
196197
_, err = sess.Insert(&LFSMetaObject{
197-
Pointer: lfs.Pointer{Oid: metas[i].Oid, Size: metas[i].Size},
198+
Pointer: p,
198199
RepositoryID: repoID,
199200
})
200201
if err != nil {
201-
log.Warn("failed to insert LFS meta object into database, err=%v", err)
202+
log.Warn("failed to insert LFS meta object %-v for repo_id: %d into database, err=%v", p, repoID, err)
202203
}
203204
}
204205
}

‎modules/lfs/pointer.go

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,8 @@ import (
1414
"regexp"
1515
"strconv"
1616
"strings"
17+
18+
"code.gitea.io/gitea/modules/log"
1719
)
1820

1921
const (
@@ -111,6 +113,17 @@ func (p Pointer) RelativePath() string {
111113
return path.Join(p.Oid[0:2], p.Oid[2:4], p.Oid[4:])
112114
}
113115

116+
// ColorFormat provides a basic color format for a Team
117+
func (p Pointer) ColorFormat(s fmt.State) {
118+
if p.Oid == "" && p.Size == 0 {
119+
log.ColorFprintf(s, "<empty>")
120+
return
121+
}
122+
log.ColorFprintf(s, "%s:%d",
123+
log.NewColoredIDValue(p.Oid),
124+
p.Size)
125+
}
126+
114127
// GeneratePointer generates a pointer for arbitrary content
115128
func GeneratePointer(content io.Reader) (Pointer, error) {
116129
h := sha256.New()

‎modules/repository/repo.go

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -254,7 +254,7 @@ func SyncReleasesWithTags(repo *repo_model.Repository, gitRepo *git.Repository)
254254
opts.Page = page
255255
rels, err := models.GetReleasesByRepoID(repo.ID, opts)
256256
if err != nil {
257-
return fmt.Errorf("GetReleasesByRepoID: %v", err)
257+
return fmt.Errorf("unable to GetReleasesByRepoID in Repo[%d:%s/%s]: %w", repo.ID, repo.OwnerName, repo.Name, err)
258258
}
259259
if len(rels) == 0 {
260260
break
@@ -265,11 +265,11 @@ func SyncReleasesWithTags(repo *repo_model.Repository, gitRepo *git.Repository)
265265
}
266266
commitID, err := gitRepo.GetTagCommitID(rel.TagName)
267267
if err != nil && !git.IsErrNotExist(err) {
268-
return fmt.Errorf("GetTagCommitID: %s: %v", rel.TagName, err)
268+
return fmt.Errorf("unable to GetTagCommitID for %q in Repo[%d:%s/%s]: %w", rel.TagName, repo.ID, repo.OwnerName, repo.Name, err)
269269
}
270270
if git.IsErrNotExist(err) || commitID != rel.Sha1 {
271271
if err := models.PushUpdateDeleteTag(repo, rel.TagName); err != nil {
272-
return fmt.Errorf("PushUpdateDeleteTag: %s: %v", rel.TagName, err)
272+
return fmt.Errorf("unable to PushUpdateDeleteTag: %q in Repo[%d:%s/%s]: %w", rel.TagName, repo.ID, repo.OwnerName, repo.Name, err)
273273
}
274274
} else {
275275
existingRelTags[strings.ToLower(rel.TagName)] = struct{}{}
@@ -278,12 +278,12 @@ func SyncReleasesWithTags(repo *repo_model.Repository, gitRepo *git.Repository)
278278
}
279279
tags, err := gitRepo.GetTags(0, 0)
280280
if err != nil {
281-
return fmt.Errorf("GetTags: %v", err)
281+
return fmt.Errorf("unable to GetTags in Repo[%d:%s/%s]: %w", repo.ID, repo.OwnerName, repo.Name, err)
282282
}
283283
for _, tagName := range tags {
284284
if _, ok := existingRelTags[strings.ToLower(tagName)]; !ok {
285285
if err := PushUpdateAddTag(repo, gitRepo, tagName); err != nil {
286-
return fmt.Errorf("pushUpdateAddTag: %v", err)
286+
return fmt.Errorf("unable to PushUpdateAddTag: %q to Repo[%d:%s/%s]: %w", tagName, repo.ID, repo.OwnerName, repo.Name, err)
287287
}
288288
}
289289
}
@@ -294,11 +294,11 @@ func SyncReleasesWithTags(repo *repo_model.Repository, gitRepo *git.Repository)
294294
func PushUpdateAddTag(repo *repo_model.Repository, gitRepo *git.Repository, tagName string) error {
295295
tag, err := gitRepo.GetTag(tagName)
296296
if err != nil {
297-
return fmt.Errorf("GetTag: %v", err)
297+
return fmt.Errorf("unable to GetTag: %w", err)
298298
}
299299
commit, err := tag.Commit(gitRepo)
300300
if err != nil {
301-
return fmt.Errorf("Commit: %v", err)
301+
return fmt.Errorf("unable to get tag Commit: %w", err)
302302
}
303303

304304
sig := tag.Tagger
@@ -315,14 +315,14 @@ func PushUpdateAddTag(repo *repo_model.Repository, gitRepo *git.Repository, tagN
315315
if sig != nil {
316316
author, err = user_model.GetUserByEmail(sig.Email)
317317
if err != nil && !user_model.IsErrUserNotExist(err) {
318-
return fmt.Errorf("GetUserByEmail: %v", err)
318+
return fmt.Errorf("unable to GetUserByEmail for %q: %w", sig.Email, err)
319319
}
320320
createdAt = sig.When
321321
}
322322

323323
commitsCount, err := commit.CommitsCount()
324324
if err != nil {
325-
return fmt.Errorf("CommitsCount: %v", err)
325+
return fmt.Errorf("unable to get CommitsCount: %w", err)
326326
}
327327

328328
rel := models.Release{
@@ -359,14 +359,14 @@ func StoreMissingLfsObjectsInRepository(ctx context.Context, repo *repo_model.Re
359359

360360
_, err := models.NewLFSMetaObject(&models.LFSMetaObject{Pointer: p, RepositoryID: repo.ID})
361361
if err != nil {
362-
log.Error("Error creating LFS meta object %v: %v", p, err)
362+
log.Error("Repo[%-v]: Error creating LFS meta object %-v: %v", repo, p, err)
363363
return err
364364
}
365365

366366
if err := contentStore.Put(p, content); err != nil {
367-
log.Error("Error storing content for LFS meta object %v: %v", p, err)
367+
log.Error("Repo[%-v]: Error storing content for LFS meta object %-v: %v", repo, p, err)
368368
if _, err2 := models.RemoveLFSMetaObjectByOid(repo.ID, p.Oid); err2 != nil {
369-
log.Error("Error removing LFS meta object %v: %v", p, err2)
369+
log.Error("Repo[%-v]: Error removing LFS meta object %-v: %v", repo, p, err2)
370370
}
371371
return err
372372
}
@@ -386,32 +386,32 @@ func StoreMissingLfsObjectsInRepository(ctx context.Context, repo *repo_model.Re
386386
for pointerBlob := range pointerChan {
387387
meta, err := models.GetLFSMetaObjectByOid(repo.ID, pointerBlob.Oid)
388388
if err != nil && err != models.ErrLFSObjectNotExist {
389-
log.Error("Error querying LFS meta object %v: %v", pointerBlob.Pointer, err)
389+
log.Error("Repo[%-v]: Error querying LFS meta object %-v: %v", repo, pointerBlob.Pointer, err)
390390
return err
391391
}
392392
if meta != nil {
393-
log.Trace("Skipping unknown LFS meta object %v", pointerBlob.Pointer)
393+
log.Trace("Repo[%-v]: Skipping unknown LFS meta object %-v", repo, pointerBlob.Pointer)
394394
continue
395395
}
396396

397-
log.Trace("LFS object %v not present in repository %s", pointerBlob.Pointer, repo.FullName())
397+
log.Trace("Repo[%-v]: LFS object %-v not present in repository", repo, pointerBlob.Pointer)
398398

399399
exist, err := contentStore.Exists(pointerBlob.Pointer)
400400
if err != nil {
401-
log.Error("Error checking if LFS object %v exists: %v", pointerBlob.Pointer, err)
401+
log.Error("Repo[%-v]: Error checking if LFS object %-v exists: %v", repo, pointerBlob.Pointer, err)
402402
return err
403403
}
404404

405405
if exist {
406-
log.Trace("LFS object %v already present; creating meta object", pointerBlob.Pointer)
406+
log.Trace("Repo[%-v]: LFS object %-v already present; creating meta object", repo, pointerBlob.Pointer)
407407
_, err := models.NewLFSMetaObject(&models.LFSMetaObject{Pointer: pointerBlob.Pointer, RepositoryID: repo.ID})
408408
if err != nil {
409-
log.Error("Error creating LFS meta object %v: %v", pointerBlob.Pointer, err)
409+
log.Error("Repo[%-v]: Error creating LFS meta object %-v: %v", repo, pointerBlob.Pointer, err)
410410
return err
411411
}
412412
} else {
413413
if setting.LFS.MaxFileSize > 0 && pointerBlob.Size > setting.LFS.MaxFileSize {
414-
log.Info("LFS object %v download denied because of LFS_MAX_FILE_SIZE=%d < size %d", pointerBlob.Pointer, setting.LFS.MaxFileSize, pointerBlob.Size)
414+
log.Info("Repo[%-v]: LFS object %-v download denied because of LFS_MAX_FILE_SIZE=%d < size %d", repo, pointerBlob.Pointer, setting.LFS.MaxFileSize, pointerBlob.Size)
415415
continue
416416
}
417417

@@ -432,7 +432,7 @@ func StoreMissingLfsObjectsInRepository(ctx context.Context, repo *repo_model.Re
432432

433433
err, has := <-errChan
434434
if has {
435-
log.Error("Error enumerating LFS objects for repository: %v", err)
435+
log.Error("Repo[%-v]: Error enumerating LFS objects for repository: %v", repo, err)
436436
return err
437437
}
438438

‎services/mirror/mirror_pull.go

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -201,7 +201,7 @@ func runSync(ctx context.Context, m *repo_model.Mirror) ([]*mirrorSyncResult, bo
201201

202202
remoteAddr, remoteErr := git.GetRemoteAddress(ctx, repoPath, m.GetRemoteName())
203203
if remoteErr != nil {
204-
log.Error("GetRemoteAddress Error %v", remoteErr)
204+
log.Error("SyncMirrors [repo: %-v]: GetRemoteAddress Error %v", m.Repo, remoteErr)
205205
}
206206

207207
stdoutBuilder := strings.Builder{}
@@ -225,7 +225,7 @@ func runSync(ctx context.Context, m *repo_model.Mirror) ([]*mirrorSyncResult, bo
225225

226226
// Now check if the error is a resolve reference due to broken reference
227227
if strings.Contains(stderr, "unable to resolve reference") && strings.Contains(stderr, "reference broken") {
228-
log.Warn("Failed to update mirror repository %-v due to broken references:\nStdout: %s\nStderr: %s\nErr: %v\nAttempting Prune", m.Repo, stdoutMessage, stderrMessage, err)
228+
log.Warn("SyncMirrors [repo: %-v]: failed to update mirror repository due to broken references:\nStdout: %s\nStderr: %s\nErr: %v\nAttempting Prune", m.Repo, stdoutMessage, stderrMessage, err)
229229
err = nil
230230

231231
// Attempt prune
@@ -255,7 +255,7 @@ func runSync(ctx context.Context, m *repo_model.Mirror) ([]*mirrorSyncResult, bo
255255

256256
// If there is still an error (or there always was an error)
257257
if err != nil {
258-
log.Error("Failed to update mirror repository %-v:\nStdout: %s\nStderr: %s\nErr: %v", m.Repo, stdoutMessage, stderrMessage, err)
258+
log.Error("SyncMirrors [repo: %-v]: failed to update mirror repository:\nStdout: %s\nStderr: %s\nErr: %v", m.Repo, stdoutMessage, stderrMessage, err)
259259
desc := fmt.Sprintf("Failed to update mirror repository '%s': %s", repoPath, stderrMessage)
260260
if err = admin_model.CreateRepositoryNotice(desc); err != nil {
261261
log.Error("CreateRepositoryNotice: %v", err)
@@ -267,28 +267,28 @@ func runSync(ctx context.Context, m *repo_model.Mirror) ([]*mirrorSyncResult, bo
267267

268268
gitRepo, err := git.OpenRepositoryCtx(ctx, repoPath)
269269
if err != nil {
270-
log.Error("OpenRepository: %v", err)
270+
log.Error("SyncMirrors [repo: %-v]: failed to OpenRepository: %v", m.Repo, err)
271271
return nil, false
272272
}
273273

274274
log.Trace("SyncMirrors [repo: %-v]: syncing releases with tags...", m.Repo)
275275
if err = repo_module.SyncReleasesWithTags(m.Repo, gitRepo); err != nil {
276-
log.Error("Failed to synchronize tags to releases for repository: %v", err)
276+
log.Error("SyncMirrors [repo: %-v]: failed to synchronize tags to releases: %v", m.Repo, err)
277277
}
278278

279279
if m.LFS && setting.LFS.StartServer {
280280
log.Trace("SyncMirrors [repo: %-v]: syncing LFS objects...", m.Repo)
281281
endpoint := lfs.DetermineEndpoint(remoteAddr.String(), m.LFSEndpoint)
282282
lfsClient := lfs.NewClient(endpoint, nil)
283283
if err = repo_module.StoreMissingLfsObjectsInRepository(ctx, m.Repo, gitRepo, lfsClient); err != nil {
284-
log.Error("Failed to synchronize LFS objects for repository: %v", err)
284+
log.Error("SyncMirrors [repo: %-v]: failed to synchronize LFS objects for repository: %v", m.Repo, err)
285285
}
286286
}
287287
gitRepo.Close()
288288

289289
log.Trace("SyncMirrors [repo: %-v]: updating size of repository", m.Repo)
290290
if err := models.UpdateRepoSize(db.DefaultContext, m.Repo); err != nil {
291-
log.Error("Failed to update size for mirror repository: %v", err)
291+
log.Error("SyncMirrors [repo: %-v]: failed to update size for mirror repository: %v", m.Repo, err)
292292
}
293293

294294
if m.Repo.HasWiki() {
@@ -311,7 +311,7 @@ func runSync(ctx context.Context, m *repo_model.Mirror) ([]*mirrorSyncResult, bo
311311

312312
remoteAddr, remoteErr := git.GetRemoteAddress(ctx, wikiPath, m.GetRemoteName())
313313
if remoteErr != nil {
314-
log.Error("GetRemoteAddress Error %v", remoteErr)
314+
log.Error("SyncMirrors [repo: %-v Wiki]: unable to get GetRemoteAddress Error %v", m.Repo, remoteErr)
315315
}
316316

317317
// sanitize the output, since it may contain the remote address, which may
@@ -322,7 +322,7 @@ func runSync(ctx context.Context, m *repo_model.Mirror) ([]*mirrorSyncResult, bo
322322

323323
// Now check if the error is a resolve reference due to broken reference
324324
if strings.Contains(stderrMessage, "unable to resolve reference") && strings.Contains(stderrMessage, "reference broken") {
325-
log.Warn("Failed to update mirror wiki repository %-v due to broken references:\nStdout: %s\nStderr: %s\nErr: %v\nAttempting Prune", m.Repo, stdoutMessage, stderrMessage, err)
325+
log.Warn("SyncMirrors [repo: %-v Wiki]: failed to update mirror wiki repository due to broken references:\nStdout: %s\nStderr: %s\nErr: %v\nAttempting Prune", m.Repo, stdoutMessage, stderrMessage, err)
326326
err = nil
327327

328328
// Attempt prune
@@ -350,7 +350,7 @@ func runSync(ctx context.Context, m *repo_model.Mirror) ([]*mirrorSyncResult, bo
350350

351351
// If there is still an error (or there always was an error)
352352
if err != nil {
353-
log.Error("Failed to update mirror repository wiki %-v:\nStdout: %s\nStderr: %s\nErr: %v", m.Repo, stdoutMessage, stderrMessage, err)
353+
log.Error("SyncMirrors [repo: %-v Wiki]: failed to update mirror repository wiki:\nStdout: %s\nStderr: %s\nErr: %v", m.Repo, stdoutMessage, stderrMessage, err)
354354
desc := fmt.Sprintf("Failed to update mirror repository wiki '%s': %s", wikiPath, stderrMessage)
355355
if err = admin_model.CreateRepositoryNotice(desc); err != nil {
356356
log.Error("CreateRepositoryNotice: %v", err)
@@ -364,7 +364,7 @@ func runSync(ctx context.Context, m *repo_model.Mirror) ([]*mirrorSyncResult, bo
364364
log.Trace("SyncMirrors [repo: %-v]: invalidating mirror branch caches...", m.Repo)
365365
branches, _, err := git.GetBranchesByPath(ctx, m.Repo.RepoPath(), 0, 0)
366366
if err != nil {
367-
log.Error("GetBranches: %v", err)
367+
log.Error("SyncMirrors [repo: %-v]: failed to GetBranches: %v", m.Repo, err)
368368
return nil, false
369369
}
370370

@@ -385,12 +385,12 @@ func SyncPullMirror(ctx context.Context, repoID int64) bool {
385385
return
386386
}
387387
// There was a panic whilst syncMirrors...
388-
log.Error("PANIC whilst syncMirrors[%d] Panic: %v\nStacktrace: %s", repoID, err, log.Stack(2))
388+
log.Error("PANIC whilst SyncMirrors[repo_id: %d] Panic: %v\nStacktrace: %s", repoID, err, log.Stack(2))
389389
}()
390390

391391
m, err := repo_model.GetMirrorByRepoID(repoID)
392392
if err != nil {
393-
log.Error("GetMirrorByRepoID [%d]: %v", repoID, err)
393+
log.Error("SyncMirrors [repo_id: %v]: unable to GetMirrorByRepoID: %v", repoID, err)
394394
return false
395395
}
396396

@@ -406,7 +406,7 @@ func SyncPullMirror(ctx context.Context, repoID int64) bool {
406406
log.Trace("SyncMirrors [repo: %-v]: Scheduling next update", m.Repo)
407407
m.ScheduleNextUpdate()
408408
if err = repo_model.UpdateMirror(m); err != nil {
409-
log.Error("UpdateMirror [%d]: %v", m.RepoID, err)
409+
log.Error("SyncMirrors [repo: %-v]: failed to UpdateMirror with next update date: %v", m.Repo, err)
410410
return false
411411
}
412412

@@ -417,7 +417,7 @@ func SyncPullMirror(ctx context.Context, repoID int64) bool {
417417
log.Trace("SyncMirrors [repo: %-v]: %d branches updated", m.Repo, len(results))
418418
gitRepo, err = git.OpenRepositoryCtx(ctx, m.Repo.RepoPath())
419419
if err != nil {
420-
log.Error("OpenRepository [%d]: %v", m.RepoID, err)
420+
log.Error("SyncMirrors [repo: %-v]: unable to OpenRepository: %v", m.Repo, err)
421421
return false
422422
}
423423
defer gitRepo.Close()
@@ -444,7 +444,7 @@ func SyncPullMirror(ctx context.Context, repoID int64) bool {
444444
}
445445
commitID, err := gitRepo.GetRefCommitID(result.refName)
446446
if err != nil {
447-
log.Error("gitRepo.GetRefCommitID [repo_id: %d, ref_name: %s]: %v", m.RepoID, result.refName, err)
447+
log.Error("SyncMirrors [repo: %-v]: unable to GetRefCommitID [ref_name: %s]: %v", m.Repo, result.refName, err)
448448
continue
449449
}
450450
notification.NotifySyncPushCommits(m.Repo.MustOwner(), m.Repo, &repo_module.PushUpdateOptions{
@@ -465,17 +465,17 @@ func SyncPullMirror(ctx context.Context, repoID int64) bool {
465465
// Push commits
466466
oldCommitID, err := git.GetFullCommitID(gitRepo.Ctx, gitRepo.Path, result.oldCommitID)
467467
if err != nil {
468-
log.Error("GetFullCommitID [%d]: %v", m.RepoID, err)
468+
log.Error("SyncMirrors [repo: %-v]: unable to get GetFullCommitID[%s]: %v", m.Repo, result.oldCommitID, err)
469469
continue
470470
}
471471
newCommitID, err := git.GetFullCommitID(gitRepo.Ctx, gitRepo.Path, result.newCommitID)
472472
if err != nil {
473-
log.Error("GetFullCommitID [%d]: %v", m.RepoID, err)
473+
log.Error("SyncMirrors [repo: %-v]: unable to get GetFullCommitID [%s]: %v", m.Repo, result.newCommitID, err)
474474
continue
475475
}
476476
commits, err := gitRepo.CommitsBetweenIDs(newCommitID, oldCommitID)
477477
if err != nil {
478-
log.Error("CommitsBetweenIDs [repo_id: %d, new_commit_id: %s, old_commit_id: %s]: %v", m.RepoID, newCommitID, oldCommitID, err)
478+
log.Error("SyncMirrors [repo: %-v]: unable to get CommitsBetweenIDs [new_commit_id: %s, old_commit_id: %s]: %v", m.Repo, newCommitID, oldCommitID, err)
479479
continue
480480
}
481481

@@ -497,12 +497,12 @@ func SyncPullMirror(ctx context.Context, repoID int64) bool {
497497
// Get latest commit date and update to current repository updated time
498498
commitDate, err := git.GetLatestCommitTime(ctx, m.Repo.RepoPath())
499499
if err != nil {
500-
log.Error("GetLatestCommitDate [%d]: %v", m.RepoID, err)
500+
log.Error("SyncMirrors [repo: %-v]: unable to GetLatestCommitDate: %v", m.Repo, err)
501501
return false
502502
}
503503

504504
if err = repo_model.UpdateRepositoryUpdatedTime(m.RepoID, commitDate); err != nil {
505-
log.Error("Update repository 'updated_unix' [%d]: %v", m.RepoID, err)
505+
log.Error("SyncMirrors [repo: %-v]: unable to update repository 'updated_unix': %v", m.Repo, err)
506506
return false
507507
}
508508

0 commit comments

Comments
 (0)